International Enhancements for Multi-Storefront
These features are available in all Enterprise stores. To become an enterprise customer, contact your BigCommerce Customer Service Manager or our support team (opens in a new tab).
International Enhancements for Multi-Storefront allow merchants to deliver localized experiences to fit different shopper needs. You can express product details differently across cultures and countries. For example, when selling products internationally, you can add information for products in various languages. Shoppers can then see key product details in the language of their choice throughout the complete checkout and post-order experience for a personalized shopping experience. This personalized shopping experience helps shoppers find and learn information about a product before purchasing.
The following pages provide sample queries:
- Basic product information
- Product SEO information
- Product variant options
- Product modifier options
- Product URL
- Additional product attributes
Use cases
To use these features, set product attributes to locales within storefront channels. This update overrides global product attributes. Product attributes you can customize include the product name, description, variant options, modifier options, and SEO settings.
This allows you to perform the following:
- Customize product name and description for culture or language
- Optimize SEO or display product options and variations based on country
- Create additional brands to position the same product to multiple market segments and shopper personas
- Tailor product content for different countries that have different compliance regulations
- Display relevant seasonal or featured products
- Enable two-way syncing of listings data to catalog between channels
GraphQL schema
The catalog features in International Enhancements for MSF are part of the GraphQL Admin API. You can use this GraphQL management API to set and query catalog data for a locale within a channel.
Request URL:
https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
Path Parameters:
| Name | Type | Description | Required |
|---|---|---|---|
STORE_HASH | string | Unique ID for a store | Yes |
For a full schema, see the GraphQL Admin API reference (opens in a new tab).
Authentication
The GraphQL Admin API works with store-level API accounts.
Authentication header
Your requests should have the following for authentication.
| Header | Argument | Description |
|---|---|---|
X-Auth-Token | access_token | For more about API accounts that generate access_tokens, see API Accounts and OAuth Scopes. |
For example requests and more information about authenticating BigCommerce APIs, see Authentication and Example Requests.
OAuth scopes
The API account should have the following OAuth scopes.
| UI Name | Permission | Parameter |
|---|---|---|
| Products | modify | store_v2_products |
| Products | read-only | store_v2_products_read_only |
For more about BigCommerce OAuth scopes, see API Accounts and OAuth Scopes.