Skip to content

Conversation

@kristinapototska
Copy link
Contributor

@kristinapototska kristinapototska commented Jan 6, 2026

CSS-1937 / CSS-1953

What/Why?

Add documentation for Order Statuses and Promotions translations in the Translations Admin GraphQL API. Two new docs (order-statuses.mdx, promotions.mdx) follow the existing pattern with list/by-id/update/delete examples.

Rollout/Rollback Plan

  • Documentation only
  • Revert if needed

Testing Details

Manual Testing

- TBD

- Add order-statuses.mdx with list/by-id/update/delete examples
- Add promotions.mdx with list/by-id/update/delete examples
- Update index.mdx to include Order Statuses and Promotions
@kristinapototska kristinapototska marked this pull request as ready for review January 6, 2026 11:19

This query returns up to 50 order status translations for the specified resource type, channel, and locale.

The request below uses several variables for reusability. Replace `{{channel_id}}` and `{{locale_code}}` with the appropriate values for your use case.
Copy link

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 🐶
reusability is misspelt; did you mean readability? retext-spell retext-spell


### Query a Translation by Resource ID

This query returns translation(s) by resourceId.
Copy link

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 🐶
resourceId is misspelt; did you mean resourceD? retext-spell retext-spell


This query returns translation(s) by resourceId.

The request below uses several variables for reusability. Replace `{{resourceId}}`, `{{channel_id}}`, and `{{locale_code}}` with appropriate values for your use case. Make sure `resourceId` follows the format from the [Resource fields](#resource-fields) table.
Copy link

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 🐶
reusability is misspelt; did you mean readability? retext-spell retext-spell


This query returns up to 50 promotion translations for the specified resource type, channel, and locale.

The request below uses several variables for reusability. Replace `{{channel_id}}` and `{{locale_code}}` with the appropriate values for your use case.
Copy link

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 🐶
reusability is misspelt; did you mean readability? retext-spell retext-spell


### Query a Translation by Resource ID

This query returns translation(s) by resourceId.
Copy link

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 🐶
resourceId is misspelt; did you mean resourceD? retext-spell retext-spell

When querying a translation by `resourceId`, you must provide the full `resourceId` in the format `bc/store/promotion/{promotion_id}`.
</Callout>

The request below uses several variables for reusability. Replace `{{resourceId}}`, `{{channel_id}}`, and `{{locale_code}}` with appropriate values for your use case. Make sure `resourceId` follows the format from the [Resource fields](#resource-fields) table.
Copy link

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 🐶
reusability is misspelt; did you mean readability? retext-spell retext-spell

* Brands
* [Product Filters](/docs/store-operations/translations/filters)
* [Locations](/docs/store-operations/translations/locations)
* [Order Statuses](/docs/store-operations/translations/order-statuses)
Copy link

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 🐶
Link to /docs/store-operations/translations/order-statuses is dead no-dead-urls remark-lint

* [Product Filters](/docs/store-operations/translations/filters)
* [Locations](/docs/store-operations/translations/locations)
* [Order Statuses](/docs/store-operations/translations/order-statuses)
* [Promotions](/docs/store-operations/translations/promotions)
Copy link

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 🐶
Link to /docs/store-operations/translations/promotions is dead no-dead-urls remark-lint

- [Product Listing Page Translations](/docs/store-operations/translations/listings)
- [Product Filter Translations](/docs/store-operations/translations/filters)
- [Inventory Locations Translations](/docs/store-operations/translations/locations)
- [Order Status Translations](/docs/store-operations/translations/order-statuses)
Copy link

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 🐶
Link to /docs/store-operations/translations/order-statuses is dead no-dead-urls remark-lint

- [Product Filter Translations](/docs/store-operations/translations/filters)
- [Inventory Locations Translations](/docs/store-operations/translations/locations)
- [Order Status Translations](/docs/store-operations/translations/order-statuses)
- [Promotions Translations](/docs/store-operations/translations/promotions)
Copy link

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 🐶
Link to /docs/store-operations/translations/promotions is dead no-dead-urls remark-lint

@kristinapototska
Copy link
Contributor Author

@bc-vincent-zhao @YevenLourance @matt-evangelidis can you please have a final look at this PR and let @bc-terra know if this one is ready to be merged and released to public dev docs.
Thanks 🙇‍♀️

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants