From deff1eb7e9dde665093d9d332558d2a361b1877c Mon Sep 17 00:00:00 2001 From: jose_ugalde Date: Wed, 29 Oct 2025 19:51:54 -0600 Subject: [PATCH] docs(search): ES-5868 Enhance multi-language support description Updated the documentation to clarify that the Storefront GraphQL API supports product search, filters, and facets in multiple languages, ensuring product information is returned in the shopper's preferred language based on the Accept-Language HTTP header or customer settings. --- .../headless/products/faceted-textual-search.mdx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) 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).