Product JSON-LD · Shopify

You are helping me add AI-search JSON-LD to ONE product on my Shopify store, safely.

SAFETY (follow exactly, in order):
  1. Back up first: duplicate the current theme (or export it) BEFORE any write. No exceptions.
  2. Work on an UNPUBLISHED copy / preview — never edit the live theme directly.
  3. Use a least-privilege token: only the scopes the task needs.
  4. After each change, VERIFY (fetch the page, confirm the JSON-LD renders and is valid).
  5. Do NOT publish. Show the human the preview and the verification, and let the human approve the publish.
  6. Keep the rollback ready: if anything looks wrong, restore the backed-up theme.

CONTEXT:
  - Store platform: Shopify. Product handle: your-product. Product URL: https://your-store.myshopify.com/products/your-product
  - Store locales to cover: your primary language (primary: your primary language).

CREDENTIAL — get the Admin API token (this is the step to get right):
  - Creating NEW legacy in-admin custom apps ('Settings -> Apps -> Develop apps') is blocked as of Jan 1 2026. Create the app in the Shopify Partner/Dev Dashboard (or via the Shopify CLI) instead.
  - Create a CUSTOM DISTRIBUTION app and install it on the store. Grant these scopes AT INSTALL: read_products, write_products, read_themes, write_themes, write_themes_assets, read_translations, write_translations. (This task touches NO protected customer data, so a staff admin can install it. Adding a scope later means releasing a new app version and the store approving the added scope -- a re-auth step -- so grant what is needed now.)
  - Installing does NOT reveal a token. Fetch it: copy the app's Client ID + API secret key from its Dev Dashboard page (or run `npx shopify app env show` once), then POST a client_credentials request to https://<store>.myshopify.com/admin/oauth/access_token to receive the Admin API access token (expires in ~24h, so refresh it before each run with the same one-line fetch). NOTE: the app's API SECRET is NOT the access token -- using the secret directly returns 401.
  - Put the token in .env as SHOPIFY_ACCESS_TOKEN; reference it by name; never print its value.

TASK:
  1. Create a translatable metafield definition `custom.so_jsonld` (JSON / multi-line text, Products scope, Translatable).
  2. Set its value on product `your-product` to the your primary language JSON-LD I provide below.
  3. For each other locale (none), register the corresponding-language JSON-LD as a translation of that metafield via Admin GraphQL `translationsRegister`.
  4. Add this snippet to the product template so the theme prints the metafield (do this on an UNPUBLISHED theme copy):
     {% if product.metafields.custom.so_jsonld %}<script type="application/ld+json">{{ product.metafields.custom.so_jsonld }}</script>{% endif %}
  5. VERIFY on the preview: fetch the product URL for each locale and confirm the <script application/ld+json> is present and is valid JSON in the right language.
  6. STOP. Show me the preview links + verification. I will approve the publish myself.

PRIMARY-LOCALE (your primary language) JSON-LD:
{}

For the other locales, ask me for each language's JSON-LD (Outcite generates one per language) before registering its translation.