Shopify App: Search Configuration

Use Search Configuration to control which facets shoppers see on your search results and collection pages.

If you have not connected a dataset yet, you will see Dataset required first. Connect your dataset, then return to this page.

What you can do here

• Create one or more reusable search configurations.
• Assign a default configuration to the:
  • Search page
  • Collection pages
• Override the default collection-page configuration for specific collections.
• Add, reorder, rename, enable, disable, edit, or remove facets in each configuration.
• Localize facet headings per storefront language.
• Synchronize your current search configuration setup to the other stores in the same dataset.

The Usage column in the list shows where a configuration is currently used:

• Search means it is assigned as the default search-page configuration.
• Collections means it is assigned as the default collection-page configuration.
• A collection-override badge shows how many collection-specific overrides use that configuration.

Create and manage configurations

1. Open Search configurations.
2. Click Create configuration.
3. Open the configuration from the list.
4. Give it a clear Name so your team can recognize it later.
5. Add and configure the facets you want to show in the storefront.

New configurations start empty, so you can build each one intentionally for a specific storefront experience.

You can delete configurations from the list page, but only when they are not in use. A configuration cannot be deleted while it is assigned to a default page or used in a collection override.

Set defaults for your storefront pages

In the Configuration assignments section:

• Set the default configuration for your Search page.
• Set the default configuration for your Collection pages.

Choose None if you do not want to apply a default configuration.

Override specific collection pages

In the Collection overrides section, you can assign a specific configuration to individual collections, such as outlet or sale collections.

1. Click Add collection override.
2. Pick a collection with Shopify's collection picker.
3. Choose the configuration that should apply to that collection.
4. Save the override.

Choose No configuration if you want to hide facets for a specific collection.

Synchronize configurations to other stores in the dataset

If your dataset contains more than one store, the list page includes an Sync to all stores action.

Use this when you want to synchronize the current search configuration setup to the other stores in the same dataset.

This action synchronizes:

• Configurations
• Search-page assignment
• Collection-page assignment

Use it carefully:

• It replaces the existing search configuration setup in the other stores.
• It does not synchronize collection overrides.
• It does not ask you to review each target store individually before applying.

Configure facets inside a configuration

In Configuration detail, the Configured facets table shows:

• Order
• Enabled
• Heading
• Key
• Type
• Actions

You can:

• Drag facets to change their order.
• Toggle facets on or off.
• Edit an existing facet.
• Delete a facet.

Add or edit a facet

When you click Add facet or Edit, configure the following fields:

1. Property key: Choose the indexed product or variant field the facet should use.
2. Facet type: Select the facet type that matches the chosen property key.
3. Scope (Selection strategy): Decide whether the facet should use product values, variant values, or fallback behavior when supported.
4. Category scope: For collection facets, choose whether the facet should use only the direct category or include ancestor categories.
5. Default heading: Set the label shoppers should see in the storefront.
6. Manage headings: Add translated headings for the available storefront languages.

The app automatically narrows the available facet types based on the selected property key, so only compatible facet types are offered.

The Scope (Selection strategy) field only appears for supported facet types. If there is only one valid scope for the selected property key, the app selects it automatically.

Saving your changes

• On the list page, creating or deleting configurations is saved immediately.
• In Configuration assignments and Collection overrides, changes are saved immediately.
• In Configuration detail, use the save bar to Save or Discard changes.

Supported facet types

The current Shopify storefront integration supports these facet types:

• Text options (String)
• Yes/No options (Boolean)
• Number options (Double)
• Number range (Double range)
• Price range (Sales price range)
• Collections (Category facet)