Add product JSON-LD to BigCommerce (for developers and for your AI agent)
The exact, verified way to put AI-search JSON-LD on a BigCommerce product page — server-side, and multilingual. Do it yourself with the steps below, hand the runbook to your AI agent, or let Store Operators do it for you.
For a developer
- Put the JSON-LD server-side in the Stencil theme (NOT the Scripts API — injected scripts run client-side, which AI crawlers may not execute).
- Create a store-level API Account (Advanced Settings → API Accounts): scopes Content=modify, Products=read. The access token is static and non-expiring.
- Edit the Stencil theme's product template (e.g. via the Stencil CLI, the Themes API, or the control panel), adding the `<script type="application/ld+json">`, then apply the theme.
Multilingual: BigCommerce Translations (GraphQL, channel + locale); emit the matching locale's JSON-LD per storefront.
View source on the product URL: application/ld+json present server-side (not only after JS).
The exact code
Prompt for your AI agent — connect BigCommerce & implement
A complete copy-paste prompt for your own AI agent (Claude / ChatGPT). It tells the agent how to connect to your BigCommerce store and implement the JSON-LD for you — with safe-write discipline: backup, preview, verify, and your approval before publishing.
You are helping me add AI-search JSON-LD to ONE product on my BigCommerce 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: Product URL: https://your-store.example/product/your-product. Store locales: your primary language.
ACCESS:
A store-level API Account token (X-Auth-Token; static, non-expiring) with Content=modify, Products=read; plus Stencil CLI access to the theme.
TASK:
1. Pull the active theme: `stencil pull`.
2. Add the JSON-LD <script> to the product template (templates/pages/product.html or a component).
3. Push it back with `stencil push` to an unpublished variation, verify the rendered source, then have the human publish.
4. For multilingual, emit the matching locale's JSON-LD (BigCommerce Translations GraphQL API).
JSON-LD to inject:
{}Questions people ask their AI
- What is the prompt to connect Claude to BigCommerce to add product JSON-LD?
- Use the runbook on this page — paste it into Claude. It connects to your BigCommerce store with your own credentials and adds the schema.org JSON-LD, with backup, preview, verification and your approval before publishing.
- How do I connect ChatGPT to my BigCommerce store to add schema.org JSON-LD?
- The same runbook works for ChatGPT (or any capable AI agent): it authenticates to your store and injects the JSON-LD server-side, safely, and stops for your approval before publishing.
- Can an AI agent add product JSON-LD to BigCommerce for AI search (ChatGPT, Perplexity, Google AI)?
- Yes — server-side (client-side-only JavaScript is not reliably seen by AI crawlers). Do it with the agent runbook here, hand it to a developer, or have Store Operators do it for you.
Sources
Get found and recommended by AI
Store Operators makes your store AI-visible and agent-ready — from a free audit to a done-for-you data layer and agentic commerce.