Skip to main content

Copy search configuration

Copying search configurations makes it much easier to manage multiple search projects.

To copy a search configuration:

  • Navigate to General Search Settings in Search Studio.
  • Click the copy icon in the top right corner.

Search Studio

  • Select the projects where you want to apply the copied configuration.
  • Confirm your selection.

Applying copied configuration to another project is irreversible, so double-check before proceeding.

What can be copied​

The copy button appears when it's possible to duplicate settings from a specific section. The most important configurations you may need to copy include:

  • Filters and sorting
  • Result mappings

Before copying result mappings, review mappings to make sure they fit the new locale. Check that:

  • The language of the target project matches the source project.
  • Any redirects are updated with the correct URLs for the new locale.

Copying settings across environments​

Copying search configurations must be done manually for each environment. Once copied, you can apply settings from the main project to all other projects within that environment.

Settings shared across projects​

Some settings are shared across projects and do not need to be copied manually:

  • Dictionaries – You can set a "parent" project that shares its dictionary entries with others. For example, all German-language projects can inherit entries from a single source project.
  • Ranking strategies – These are automatically shared between locales within the same environment.
  • Custom attributes – Attributes created in the Data Platform are shared across all projects in an environment.

Translations and extraction rules need to be manually adjusted for each language using the language switcher on the attribute.

Copy Design and Publish configuration​

Here's how you can copy Design & Publish configurations across locales within the same parent project.

Step 1: Set up multi-locale variables​

Multi-locale variables are custom fields you define in Search Designer. You can use them in any part of your plugin configuration or callback code. The variables let you manage translated UI text like:

  • Add to cart buttons
  • View names (e.g. "Grid", "List")
  • Notifications

Search Studio

To create a multi-locale variable:

  • Go to Search Studio > Design & Publish
  • Click the three-dot icon next to Publish.
  • Select Multi-locale variables.
  • Click the plus icon to create a new variable. Enter:
    • A name (e.g. cartButton)
    • A default value – this is the text shown in the main project’s language (for example, Add to cart for en-US)
    • Localized versions for each supported locale (e.g. Ajouter au panier for fr-FR)

If your main project is in English (en-US), the default value is what appears in that version of your shop. The French child project would show the localized version you define for fr-FR.

Use a variable in configuration​

Use the following syntax to reference your variable:

{{var.variableName}}

Example: If you name the variable cartButton, use {{var.cartButton}} in your config.

Step 2: Copy Design & Publish configuration to other locales​

  • Go to Search Studio > Design & Publish.
  • Click the three-dot icon next to Publish.
  • Select Copy to another locale(s).

Search Studio

  • Choose the target locale(s).
  • (Optional) Check Publish copied configurations to publish right after copying.
  • Click Copy.

This action will overwrite the current Design configuration.