Skip to content

Commit 1e96acf

Browse files
committed
fix: comments from Dymytro & Nick
1 parent 4ec01fd commit 1e96acf

File tree

3 files changed

+20
-16
lines changed

3 files changed

+20
-16
lines changed

docs/storefront/catalyst/content-management/internationalization/multi-language/overview.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ BigCommerce supports multiple locales for shoppers in different regions.
1818
* Add translations for categories and locations to multiple locales added to Catalyst channel. Learn about how to use the [GraphQL Admin API](https://developer.bigcommerce.com/docs/store-operations/translations) to add translations to a single channel and locale.
1919

2020
<Callout type="info">
21-
Managing locales (in Control Panel, CLI, or via the GraphQL Admin API) is available for Catalyst channels. As of `October 2025`, new stores have the multi-language feature enabled by default. On stores where multi-language is disabled, locale mutations and Channel Manager locale controls aren't available.
21+
Managing locales (in Control Panel, CLI, or via the GraphQL Admin API) is available for Catalyst channels. As of `October 2025`, all Catalyst stores have the multi-language feature enabled by default. On stores where multi-language is disabled, locale mutations and Channel Manager locale controls aren't available.
2222
</Callout>
2323

2424
## Default Catalyst features

docs/storefront/catalyst/content-management/internationalization/multi-language/setup.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,11 @@ Follow the [Getting Started with Catalyst](/docs/storefront/catalyst/getting-sta
1313
## Adding a locale in Catalyst
1414

1515
<Callout type="info">
16-
**Control Panel access:** The Localization tab in Channel Manager for adding/removing locales is available for Catalyst channels.
17-
**Default:** On newly created stores, multi-language is enabled by default.
16+
**Control Panel access:** The Localization tab in Channel Manager for adding/removing locales is available for Catalyst channels in **Settings** > **Localization** or via editing the channel in **Channel Manager**.
17+
**Default:** multi-language is enabled by default on all Catalyst stores.
1818
</Callout>
1919

20-
You can add additional languages to your storefront when you initially create your Catalyst storefront through the Control Panel. If you didnt do so, you have a couple of options.
20+
You can add additional languages to your storefront when you initially create your Catalyst storefront through the Control Panel. If you didn't do so, you have a couple of options.
2121

2222
You can enable more locales for your storefront through the Control Panel:
2323

docs/storefront/headless/index.mdx

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Introduction to Headless Commerce
3-
keywords: headless, commerce, storefronts, backend, frontend, whitepaper, api, sdk,
3+
keywords: headless, commerce, storefronts, backend, frontend, whitepaper, api, sdk,
44
---
55

66
# Introduction to Headless Commerce
@@ -86,7 +86,7 @@ The following example uses the GraphQL Storefront API to complete a checkout and
8686
# Correlation header matches next request
8787
X-Correlation-Id: a7d28ca2-d4b2-4dc8-9f07-0706c431a372
8888
```
89-
89+
9090
```graphql {5} filename="Example mutation: Complete checkout" showLineNumbers copy
9191
mutation completeCheckout($completeCheckoutInput: CompleteCheckoutInput!) {
9292
checkout {
@@ -107,7 +107,7 @@ The following example uses the GraphQL Storefront API to complete a checkout and
107107
```
108108
</Tab>
109109
<Tab>
110-
110+
111111
```json {6-7} filename="Example mutation: Complete checkout" showLineNumbers copy
112112
{
113113
"data": {
@@ -148,10 +148,10 @@ The following example uses the GraphQL Storefront API to complete a checkout and
148148
}
149149
150150
```
151-
151+
152152
</Tab>
153153
<Tab>
154-
154+
155155
```json filename="Example response: Process payment" showLineNumbers copy
156156
{
157157
"data": {
@@ -173,7 +173,7 @@ BigCommerce has introduced a feature that leverages the [Customer Access Token](
173173
After three attempts with invalid session-sync JWT tokens, the system will block the IP address for five minutes.
174174
</Callout>
175175

176-
The following examples demonstrate how to sync and validate session details for headless storefronts and hosted checkouts.
176+
The following examples demonstrate how to sync and validate session details for headless storefronts and hosted checkouts.
177177

178178
<Tabs items={['Format', 'Mutation', 'Validate']}>
179179
<Tab>
@@ -187,7 +187,7 @@ The following examples demonstrate how to sync and validate session details for
187187

188188
mutation GenerateSessionSyncJwt ($redirectTo: String!,$cartId: String,$visitorId: String,$ipAddress: IpAddress){
189189
generateSessionSyncJwt(redirectTo:$redirectTo,cartId: $cartId, visitorId: $visitorId, ipAddress: $ipAddress){
190-
result {
190+
result {
191191
token
192192
url
193193
}
@@ -196,7 +196,7 @@ mutation GenerateSessionSyncJwt ($redirectTo: String!,$cartId: String,$visitorId
196196
```
197197
</Tab>
198198
<Tab>
199-
199+
200200
```json # Low-level session sync JWT generation
201201
# Returns JUST a JWT, *not* a URL
202202
# Can "sync" any arbitrary combination of parameters
@@ -216,22 +216,22 @@ mutation GenerateSessionSyncJwt {
216216
</Tab>
217217

218218
<Tab>
219-
```json #
219+
```json #
220220
mutation ValidateJwt{
221221
validateSessionSyncJwt(jwt: "eyJ0eXAiOiJKV1QiLCJhbGciOiJFUzI1NiJ9.eyJpc3MiOiJCQyIsImlhdCI6MTczMDQwMTc3MiwiZWF0IjoxNzMwNDAxODAyLCJqdGkiOiI2NTI5NDAyMi02MDA4LTRmY2YtOTUxOC03MWE5NjA0MjEyMjgiLCJvcGVyYXRpb24iOiJzZXNzaW9uX3N5bmMiLCJzaWQiOjczMzE5Nywic2Vzc2lvbl9wYXlsb2FkIjp7ImNhcnRfaWQiOm51bGwsImN1c3RvbWVyX2lkIjpudWxsLCJ2aXNpdG9yX2lkIjoiYWJjMTIzIn0sInJlcXVlc3RfaXAiOm51bGwsInJlZGlyZWN0X3RvIjoiaHR0cHM6Ly9iaWdjb21tZXJjZS5zdXBwb3J0L2ZvbyJ9.TAueByfTCdpw3UwwuKElUoeEjYcqCT13H3pt7UzIh6t6682_w4aaz1akS-FOyyOstOUYcjyUPLN5qi04eXXKKA"){
222222
content{
223223
analytics{
224224
visitorId
225225
}
226226
cart{
227-
entityId
227+
entityId
228228
}
229229
customer {
230230
firstName
231231
}
232232
customerAccessToken{
233233
expiresAt
234-
value
234+
value
235235
}
236236
redirectTo
237237
}
@@ -241,12 +241,16 @@ mutation ValidateJwt{
241241
</Tab>
242242
</Tabs>
243243

244-
### Persisting analytics session IDs
244+
### Persisting analytics session IDs
245245

246246
The GraphQL API supports including a visitor ID when creating a session sync JWT using the `generateSessionSyncJwt` mutation, enhancing tracking consistency across different contexts. The visitor ID acts as a unique identifier that links a user's activity across multiple storefronts, ensuring that analytics session IDs remain persistent as users move across various parts of the storefront (e.g., Catalyst to Stencil) and other digital touchpoints.
247247

248248
Including a visitor ID in session sync requests helps maintain a cohesive session structure, providing more accurate insights into customer behavior. This is especially valuable for businesses leveraging analytics tools to track user interactions across headless storefronts, native checkouts, and other platforms.
249249

250+
## Multi-Language support
251+
252+
After **October 2025**, new headless stores will have access to Multi-language features similar to [Catalyst storefronts](/docs/storefront/catalyst/content-management/internationalization/multi-language/overview).
253+
250254
## Next step
251255

252256
- [Learn how to create a channel and a channel site](/docs/storefront/headless/channels)

0 commit comments

Comments
 (0)