Translations Admin GraphQL API (Beta)
Overview
The Translations Admin GraphQL API is currently available on Catalyst storefronts only. This API enables merchants to translate a single website into multiple languages.
With a single storefront setup, the shopper's experience remains consistent, but the content is displayed in their preferred language. This use case is particularly common in multilingual countries like Canada and for customers selling cross-border, where the same storefront serves shoppers in multiple languages without altering the overall user experience.
The API currently supports translations for the following components, and more are expected in the future:
- Categories
- Locations
Purpose and Benefits
The API helps merchants localize their storefronts efficiently, enabling a consistent shopping experience across multiple languages. This allows merchants to cater to a broader audience and expand market reach.
Authentication and Access
Access to the Translations Admin GraphQL API requires valid API credentials. GraphQL Admin API endpoints use the X-Auth-Token header to authenticate to BigCommerce servers. To make a call to the Admin GraphQL, use an API client tool such as Postman (opens in a new tab). Ensure authentication tokens are included in requests.
OAuth scopes
| Name | Permission | Description |
|---|---|---|
| Store Translations | read-only | View translation details |
| Store Translations | modify | View and modify translation details |
For more information on OAuth Scopes, see our Guide to API Accounts.
Limitations
- Currently in Beta and subject to changes
- Rate limits apply
- Only available on Catalyst storefronts
Best Practices
- Cache translations to minimize API calls.
- Avoid redundant translations by checking existing translations first