diff --git a/docs/storefront/headless/products/faceted-textual-search.mdx b/docs/storefront/headless/products/faceted-textual-search.mdx index 722701cbd..5ad691157 100644 --- a/docs/storefront/headless/products/faceted-textual-search.mdx +++ b/docs/storefront/headless/products/faceted-textual-search.mdx @@ -235,7 +235,7 @@ If you sort by price, the products sort by either their `salePrice` or `basePric ### Multi-language Product Search -The Storefront GraphQL API supports product search in multiple languages. When multi-language is enabled and translations are provided in the BigCommerce admin, the API returns product names, descriptions, and search keywords in the shopper’s preferred language—determined by the `Accept-Language` HTTP header or customer settings. +The Storefront GraphQL API supports product search, filters and facets in multiple languages. When multi-language is enabled and translations are provided in the BigCommerce GraphQL admin, the Storefront GraphQL API returns product information in the shopper's preferred language—determined by the `Accept-Language` HTTP header or customer settings. **Searchable fields include:** - Product name @@ -307,9 +307,13 @@ If a translation is missing for a product’s content in the shopper’s selecte 1. **Add the new language to your storefront/channel** – This enables you to provide translations. 2. **Set the language to "Inactive"** – Prevents incomplete content from appearing on the storefront. -3. **Localize your product content** – Add translations for product names, descriptions, etc. If a translation isn’t provided, the base content will display. +3. **Localize your product content** – Add translations for product names, descriptions, etc. If a translation isn't provided, the base content will display. 4. **Activate the language** – Make the language available for shoppers when translations are complete. + +You must specifically override product filters if you want your filters and facets to be displayed in the shoppers language. This is different from overriding custom fields or product options. + + #### Limitations, Recommendations, and Recovery - **API Availability:** Multi-language search is available only via the Storefront GraphQL API (used for headless storefronts such as Catalyst).