Skip to content

docs: Document automatic product translation for Shopify V2#1

Open
devbot-repo-access[bot] wants to merge 1 commit intomainfrom
docs/translated-product-data-v2
Open

docs: Document automatic product translation for Shopify V2#1
devbot-repo-access[bot] wants to merge 1 commit intomainfrom
docs/translated-product-data-v2

Conversation

@devbot-repo-access
Copy link

Summary

The documentation currently doesn't mention that Shopify V2 (BfS) automatically translates product titles, descriptions, and prices on the results page using the Storefront API @inContext(country, language) directive.

This is a key advantage of V2 that customers should know about.

Changes

1. change-quiz-language.md

  • Added new section "Automatic Product Translation (Shopify V2)" under the Shopify tab
  • Explains how @inContext works with the Storefront API
  • Documents requirements (Shopify Translate & Adapt app)
  • Clarifies that only quiz questions/choices need manual translation — product data comes through automatically

2. show-quiz-based-on-markets.md

  • Added success callout in Step 3 noting product data is auto-translated when Markets are configured

3. shopify-markets.md (tutorial)

  • Added callout after "Create Multiple Quizzes" section about automatic product localization

4. adapt-quizzes-to-markets.md (customer success)

  • Updated currency/pricing paragraph to mention V2's automatic currency conversion and product translation

Technical Background

The frontend_v2 code passes country and language to all Storefront API product queries via the @inContext directive (repos/frontend_v2/app/utils/shopifyFetch.ts). This means when a store has translations set up via Shopify's Translate & Adapt app, product data automatically comes back in the customer's locale.

- Add 'Automatic Product Translation' section to change-quiz-language.md
  explaining how V2 uses @incontext to fetch translated product data
- Add success callout to show-quiz-based-on-markets.md noting that
  product titles/descriptions/prices are auto-translated with Markets
- Add callout to shopify-markets.md tutorial clarifying that only quiz
  questions/choices need manual translation, not product data
- Update adapt-quizzes-to-markets.md to mention automatic currency
  conversion and product translation in V2

The V2 frontend already fetches product data with the Storefront API
@incontext(country, language) directive, which returns translated
titles, descriptions and localized prices. This was undocumented.
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.

0 participants