Skip to content

docs(search): ES-5868 Enhance multi-language support description #1139

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(search): ES-5868 Enhance multi-language support description #1139

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions docs/storefront/headless/products/faceted-textual-search.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link

@github-actions github-actions bot Oct 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Hard to read sentence (confidence: 5/7) retext-readability retext-readability


**Searchable fields include:**
- Product name
Expand Down Expand Up @@ -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.

<Callout type="warning">
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.
</Callout>

#### Limitations, Recommendations, and Recovery

- **API Availability:** Multi-language search is available only via the Storefront GraphQL API (used for headless storefronts such as Catalyst).
Expand Down