Skip to content
Русский

Query refinements and filter links

Refinements are property buttons associated with the search field. Selecting a value extends the query and refreshes the existing popup. An optional group link opens a section with the selected filter applied, rather than a product detail page.

  1. Open Query refinements and select the Bitrix site.
  2. Enable refinements for that site.
  3. Check the input CSS selector. The default is input[name="q"][autocomplete="off"]; one selector can match several search fields.
  4. Enable the filtered-section link if required.
  5. Enter the native catalog.smart.filter FILTER_NAME, for example arrFilter. The destination catalog must use the same filter.
  6. Choose the link mode below and click Save site settings.
  1. Select the catalog for this site, then find a section by name or ID.
  2. Enable refinements for that section.
  3. Find a property by name or code and click Add. Properties are sorted by name.
  4. Select the exact values to offer as refinements.
  5. Click Save for section. The main form’s Save button does not replace the dedicated refinement buttons.
  6. After changing properties or selected values, run a full module reindex: Indexing and check → All → Reindex.

New refinements are unavailable until indexing completes. Large section/property/value lists may load with a delay. Section search returns the first 100 matches; narrow the query if necessary.

Active native String, Number, List and Element link properties are supported when enabled in the selected section’s smart filter. Custom property types are excluded. The normal searchable-property flag is not required for refinements.

Choose up to 8 properties and 100 values per property. Up to 8 buttons are shown, only when matching accessible active products exist in the section or its descendants. Different selected properties are combined.

An Element link property such as Brand [BRAND] displays linked element names, for example Aurora, rather than numeric IDs. Value search uses the brand name. Matching uses the linked ID, including multiple element links, and checks linked element activity and access.

The default link uses smart-filter query parameters. Use it when the destination catalog applies those parameters.

For a catalog using SEF_MODE=Y that ignores query parameters:

  1. Enable Use smart-filter SEF URLs for the selected site.
  2. Enter the part of SEF_RULE relative to the section URL. The usual template is filter/#SMART_FILTER_PATH#/apply/.
  3. Save the site settings.

Example: /catalog/welders/filter/brand-is-aurora/apply/. Match the template to the catalog’s actual routing. Native catalog.smart.filter builds property/value codes: linked elements use their code, or their name when no code exists; lists use XML_ID. A site redirect to a brand landing page is expected when that page retains the intended product restriction.

Changing link mode, SEF template or FILTER_NAME does not require reindexing. Group links require indexed sections and properties enabled in the native smart filter. Other filter implementations need compatibility testing.

Visibility, selector, FILTER_NAME, link mode and section choices belong to the selected site. Configure a shared iblock’s section separately for each site; enabling one profile does not enable the others.

After indexing, enter the section name or a synonym, select a brand and check that the query and products update. Follow the separate group link in the refinement block and verify the destination section and active filter as a visitor. Ordinary section links in the original popup and “All results” retain their own behavior.

Refinements sit inside the existing popup without increasing header height. A separate floating block is used while the popup is unavailable. Supported components do not require template changes; verify custom components and layouts on your own site.