{"section":"tutorials","requestedLocale":"en","requestedSlug":"vtex-intelligent-search-multilanguage-settings","locale":"en","slug":"vtex-intelligent-search-multilanguage-settings","path":"docs/en/tutorials/intelligent-search/vtex-intelligent-search-multilanguage-settings.md","branch":"main","content":"[VTEX Intelligent Search](/en/docs/tracks/overview-intelligent-search) is an intelligent search application for ecommerce that is available for stores created with [VTEX IO](https://developers.vtex.com/docs/guides/store-framework). To install and configure VTEX Intelligent Search in your store, read our [Search article](https://developers.vtex.com/docs/guides/search-overview). The tool displays search and product suggestions that may interest the user, corrects spelling errors, and understands related words that are not included in the product information.\n\nVTEX Intelligent Search: Multilanguage expands [Intelligent Search’s](/en/docs/tracks/overview-intelligent-search) capabilities and offers a multilingual search experience, ideal for stores that operate in several countries. This feature facilitates adapting the store to new markets and allows users to search in many different languages.\n\n> ℹ️  If you want to expand your ecommerce to another language, contact [our Support](https://support.vtex.com/hc/pt-br/requests) and the VTEX team will perform the necessary configurations.\n\nAfter installing VTEX Intelligent Search: Multilanguage, your Catalog's information must be translated so it can be displayed in each locale configured for the store. The approach depends on the Intelligent Search API version used by your store:\n\n- **[Intelligent Search API v1](https://developers.vtex.com/docs/api-reference/intelligent-search-api-v1)**: translations are pulled natively from the [Catalog multi-language](https://developers.vtex.com/docs/guides/catalog-multi-language-integration-guide) API, so Messages is not required.\n- **[Intelligent Search API (Legacy)](https://developers.vtex.com/docs/api-reference/intelligent-search-api)**: catalog content still needs to be translated through **[Messages](https://developers.vtex.com/vtex-developer-docs/docs/catalog-internationalization)**, a GraphQL-based approach using the `catalog-graphql` app.\n\n> ⚠️ These two approaches can't be used at the same time. Once Catalog multi-language is activated for your account, you can no longer manage catalog translations through Messages (GraphQL).\n\nThe fields available for translation differ between the two approaches:\n\n| Entity | Catalog multi-language fields | Messages (legacy) fields |\n| --- | --- | --- |\n| Products | Name, Title, Description, MetaTagDescription, DescriptionShort, Keywords, LinkId | Name, keywords, page title, description, short description, meta tag description, URL slug (cross-border stores only) |\n| Categories | Name, Title, Description, Keywords, LinkId | Name, keywords, page title, meta tag description, URL slug (cross-border stores only) |\n| Brands | Name, Text, Keywords, SiteTitle, LinkId | Name, keywords, page title, meta tag description, URL slug (cross-border stores only) |\n| SKUs | Name, MeasurementUnit | Name |\n| Specifications | Name, Description | Name, description, and values |\n| Specification values | Name | Included in Specifications |\n| Specification groups | Name | Not supported |\n| Collections | Name, Description, LinkId | Not supported |\n| Services | Name, Text | Not supported |\n\nRead the developer guides on [Catalog multi-language](https://developers.vtex.com/docs/guides/catalog-multi-language-integration-guide) and [Translating Catalog content with Messages](https://developers.vtex.com/vtex-developer-docs/docs/catalog-internationalization) for more details.\n\nVTEX Intelligent Search: Multilanguage obtains all locations and respective languages (examples: `pt-br`, `en-GB`) configured for the store. Each location has its own URL.\n\nIf a customer chooses a language when browsing the store, it will redirect them to the URL of the desired location. After that, all Intelligent Search features will be displayed in the chosen language, according to the retailer's settings.\n\nVTEX Intelligent Search: Multilanguage allows you to customize the search experience for each region by assigning the following search settings to specific locations:\n\n- [Merchandising rules](#merchandising-rules)\n- [Synonyms](#synonyms)\n- [Redirects](#redirects)\n- [Banners](#banners)\n\n### Merchandising rules\nAfter installing the VTEX Intelligent Search: Multilanguage, the page for creating or editing Merchandising Rules — available on VTEX Admin through __Storefront__ > __Intelligent Search__ > __Merchandising rules__ —  will contain the additional __Locales__ field, which allows you to choose the locales to which the Merchandising Rules will apply, as shown in the image below.\n\n![img regrasmerch intelligentsearchmultilanguage EN](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/intelligent-search/vtex-intelligent-search-multilanguage-settings_1.png)\n\nTo learn more about this field, read our article on [how to configure Merchandising rules in VTEX Intelligent Search](/en/docs/tutorials/creating-merchandising-rules-manual-editor).\n\n### Synonyms\nYou can configure Synonyms for a multi-language store in the Admin by filling out a form or importing a .csv file.\n\n> ⚠️  Settings created or changed in **Synonyms** can take up to 2 hours to be applied in the store. \n\n#### Creating Synonyms via form\nAfter installing the VTEX Intelligent Search: Multilanguage, the page for creating or editing Synonyms (available through — available on VTEX Admin through __Storefront__ > __Intelligent Search__ > __Synonyms__ —  will contain the additional __Locales__ field, which allows you to choose the locales to which the Synonyms will apply, as illustrated in the image below. Click on the languages you want to select.\n\n![img sinonimos intelligentsearchmultilanguage EN](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/intelligent-search/vtex-intelligent-search-multilanguage-settings_2.png)\n\nTo learn more about this field, read our article on [how to configure Synonyms in VTEX Intelligent Search](/en/docs/tutorials/creating-synonyms).\n\n#### Importing the Synonyms spreadsheet\n\nIf you prefer to import Synonyms for specific languages via .csv file, you must create a .csv file in __Unidirectional__ or __Bidirectional__ format, according to the [desired effect for the synonym](/en/docs/tutorials/creating-synonyms), and insert the new field `<comma-separated locales>`:\n\n-\t__Unidirectional__: `<comma-separated terms>;<comma-separated expanded terms>;<status>;<comma-separated locales>`\n   -  For example: `smartphone;iPhone;true;en-GB`: when searching for smartphone in the English language store (`locale en-GB`), the website will return results for `iphone`. However, when searching for `iphone`, the website will not return results for `smartphone`.\n\n- __Bidirectional__: `<comma-separated terms>;<status>;<comma-separated locales>`\n    - For example: `tv,smart tv;true;en-GB`: when searching for one of these terms in the store in English (`locale en-GB`), the search results will return any product that contains one of these terms.\n\n> ⚠️ If the imported .csv file does not have the column `locale`, the synonym will be valid for all languages available in the store.\n\nTo learn more about importing Synonyms spreadsheets, read our article on [how to configure Synonyms in VTEX Intelligent Search](/en/docs/tutorials/creating-synonyms).\n\n### Redirects\n\nAfter installing the VTEX Intelligent Search: Multilanguage, the page for creating or editing Redirects — available on VTEX Admin through __Storefront__ > __Intelligent Search__ > __Redirects__ —  will contain the additional __Locales__ field, which allows you to choose which locales the Redirects will apply to, as illustrated in the image below. Click on the languages you want to select.\n\n![img redirecionamentos intelligentsearchmultilanguage EN](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/intelligent-search/vtex-intelligent-search-multilanguage-settings_3.png)\n\nTo learn more about this field, read our article on [how to configure Redirects in VTEX Intelligent Search](/en/docs/tutorials/configuring-redirects).\n\n### Banners\n\nAfter installing the VTEX Intelligent Search: Multilanguage, the page for creating or editing Banners — available on VTEX Admin through __Storefront__ > __Banners__ —  will contain the additional __Locales__ field, which allows you to choose which locales the Banners will apply to, as illustrated in the image below. Click on the languages you want to select.\n\n![img banner intelligentsearchmultilanguage EN](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/intelligent-search/vtex-intelligent-search-multilanguage-settings_4.png)\n\nTo learn more about this field, read our article on [how to configure Banners in VTEX Intelligent Search](/en/docs/tutorials/configuring-banners)."}