{"section":"tutorials","requestedLocale":"en","requestedSlug":"vtex-intelligent-search-multilanguage-settings-beta","locale":"en","slug":"vtex-intelligent-search-multilanguage-settings-beta","path":"docs/en/tutorials/beta/intelligent-search-beta/vtex-intelligent-search-multilanguage-settings-beta.md","branch":"main","content":"> ℹ️ This feature is in beta, which means that we are working to improve it. If you have any questions, please contact [our Support](https://support.vtex.com/hc/pt-br/requests).\n\n[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://vtex.com/br-pt/store-framework/). To install and configure VTEX Intelligent Search in your store, read our [Search article](https://developers.vtex.com/vtex-developer-docs/docs/vtex-search). 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 will be translated by the [Messages](https://developers.vtex.com/vtex-developer-docs/docs/catalog-internationalization) app, provided that you have added translations for the following fields: Name, Brand, Description, Categories, CategoryTrees, metadata, metadataKeyword, Specifications, SKU \\{name\\}. Read the developer guide on [Translating Catalog content](https://developers.vtex.com/vtex-developer-docs/docs/catalog-internationalization) for more details.\n\nFrom the [Multi-Tenant API](https://developers.vtex.com/vtex-developer-docs/docs/vtex-io-multi-language-stores), VTEX Intelligent Search: Multilanguage obtains all locations and respective languages (examples: `pt-br`, `en-GB`) that were added to the store. Each location has its 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/beta/intelligent-search-beta/vtex-intelligent-search-multilanguage-settings-beta_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/beta/intelligent-search-beta/vtex-intelligent-search-multilanguage-settings-beta_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/beta/intelligent-search-beta/vtex-intelligent-search-multilanguage-settings-beta_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/beta/intelligent-search-beta/vtex-intelligent-search-multilanguage-settings-beta_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)."}