Store Operators/en/resources/wix-json-ld#ohje
FIagent ready
Write JSON-LDWix

Product JSON-LD · Wix

Add product JSON-LD to Wix (for developers and for your AI agent)

The exact, verified way to put AI-search JSON-LD on a Wix 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.

developer guide · stepsAdvanced
01

Enable Dev Mode (Velo). In the product page's code, call `wixSeoFrontend.setStructuredData([...])` inside `$w.onReady()` — Wix renders it for crawlers.

02

Alternative: an installed Wix App can inject via the Embedded Scripts REST API (app-only — requires an authorized app, not a plain owner key).

03

Per language: Wix Multilingual + the wix-seo per-language APIs — set the matching locale's structured data.

verification and languages
Verify
View source / SEO preview per locale: the JSON-LD is present.
Multilingual
Wix Multilingual + wix-seo per-language APIs; set each locale's structured data.
Diagram: how to add product JSON-LD to Wix for AI search — Enable Velo Dev Mode; setStructuredData() in $w.onReady(); Per locale (Wix Multilingual); Preview, verify, publish
The Wix JSON-LD flow at a glance (illustrative diagram).
Agent prompt

Hand this to your own agent

This runbook adds product JSON-LD to one product at a time. It backs up first, works on an unpublished copy, verifies the result and publishes nothing without you.

runbook · wix-json-ld.md · en1 134 merkkiä
You are helping me add AI-search JSON-LD to ONE product on my Wix 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:
  Wix Dev Mode (Velo) enabled on the site, or an installed & authorized Wix App for the Embedded Scripts API.

TASK:
  1. Enable Velo Dev Mode.
  2. On the product page, call wixSeoFrontend.setStructuredData([...]) inside $w.onReady().
  3. Set the matching locale's structured data (Wix Multilingual), preview, verify, then have the human publish.

JSON-LD to inject:
{}
Writes only after your approval. The runbook forces the agent to back up before writing, work on an unpublished copy and verify the result. Publishing stays with you.

The runbook is in English on purpose — agent prompts work most reliably in English. You can still talk to the agent in your own language.

Already have your JSON-LD?

Outcite outputs a finished, per-language JSON-LD. Then the agent doesn't invent fields, it only installs the blocks correctly. Tell it how many language versions you have and the prompt adapts.

install · wix-json-ld.md0 / 1 täytetty521 merkkiä
I already have a finished product JSON-LD from Outcite. Do NOT generate a new one and do NOT change its contents.

Platform: Wix. Locales: 

I have one JSON-LD block.

Do this:
1. Install it so it renders server-side on the product page.
2. Do not alter any field values.
3. Verify the rendered page and show me the JSON-LD it outputs.

SAFETY: back up before any write, work on an unpublished copy, publish nothing without my approval, and tell me the rollback.

Paste the Outcite blocks below this line:
---
Installs, doesn't invent. The prompt forbids the agent from altering field values. With several locales it forces the platform's own translation mechanism instead of duplicated code.

Don't have your JSON-LD yet? Generate it with Outcite — it outputs a per-language block for every language version.

Frequently asked
01What is the prompt to connect Claude to Wix to add product JSON-LD?

Use the runbook on this page — paste it into Claude. It connects to your Wix store with your own credentials and adds the schema.org JSON-LD, with backup, preview, verification and your approval before publishing.

02How do I connect ChatGPT to my Wix 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.

03Can an AI agent add product JSON-LD to Wix 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
next · 30 seconds

What does your store look like to AI?

A free audit. No signup, works on every platform.

Book
● agent readyWixAdvancedWix · Advanced