Add product JSON-LD to Magento / Adobe Commerce (for developers and for your AI agent)
The exact, verified way to put AI-search JSON-LD on a Magento / Adobe Commerce 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.
The Magento / Adobe Commerce JSON-LD flow at a glance (illustrative diagram).
For a developer
Auth is OAuth 1.0a (integration token; admin bearer tokens expire in 4h and require 2FA). Create an Integration for a stable token.
Fastest server-side path: create/update a CMS Block via REST (POST /V1/cmsBlock) whose content includes the JSON-LD `<script>`, then PLACE that block on the product page via a widget or layout XML (a REST-created block is not shown until placed); or edit the theme .phtml over SSH.
Per store-view: scope via the store code in the route (/rest/<store_code>/V1/...) and emit that store-view's JSON-LD.
Per store-view via the store code in the REST route; emit that view's JSON-LD.
View source on the product URL per store-view: application/ld+json present.
The exact code
Prompt for your AI agent — connect Magento / Adobe Commerce & implement
A complete copy-paste prompt for your own AI agent (Claude / ChatGPT). It tells the agent how to connect to your Magento / Adobe Commerce 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 Magento / Adobe Commerce 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 Magento/Adobe Commerce Integration token (OAuth 1.0a); or SSH + bin/magento for theme .phtml edits.
TASK:
1. Create an Integration and use its OAuth 1.0a token.
2. POST the JSON-LD as a CMS Block (/V1/cmsBlock) and render it on the product page — OR edit the theme .phtml over SSH.
3. Scope per store-view (/rest/<store_code>/V1/...) for multilingual, verify the source, then have the human publish.
JSON-LD to inject:
{}
Questions people ask their AI
What is the prompt to connect Claude to Magento / Adobe Commerce to add product JSON-LD?
Use the runbook on this page — paste it into Claude. It connects to your Magento / Adobe Commerce 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 Magento / Adobe Commerce 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 Magento / Adobe Commerce 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.
