Install the Schema Injector
Plans: Starter ✓ · Growth ✓ · Pro ✓ · Agency ✓
The Schema Injector tab in Store Settings is where you connect Clione's storefront pieces to your theme and check that they're live. What it installs depends on your platform.
Your JSON-LD doesn't depend on a script. On BigCommerce it's rendered server-side from a Widget API placement; on Shopify, by the Clione SEO app embed. In both cases it reaches the page when you publish the entity. If you came here asking "why is my schema not live?", the answer is usually that the entity hasn't been published yet — see Publish.
Which path applies to you?
| Your setup | What you set up | How |
|---|---|---|
| BigCommerce, Stencil theme | The Schema Injector script, installed by Clione through BigCommerce's Scripts API. It renders the FAQ accordion and the agent-discovery links. | One click — see below. |
| BigCommerce, headless / Catalyst | The @clione/seo SDK or the SEO signals API, in your frontend. | Developer task — see Headless on Next.js. |
| Shopify, Online Store theme (any Liquid theme) | The Clione SEO and Clione FAQ app embeds of Clione's Shopify app. No script. | Turn them on in the theme editor — see below. |
| Shopify, Hydrogen / headless | The @clione/seo SDK or the SEO signals API. | Developer task — see Headless on Hydrogen. |
If you're not sure, you're almost certainly not headless: headless means a custom frontend your developers built and deploy separately.
BigCommerce — Stencil (classic storefront)
What the script does
The script is registered in BigCommerce's Script Manager as Clione FAQ Renderer. On every storefront page it:
- renders the visible FAQ accordion for the page's product, category or content page;
- applies your custom FAQ CSS;
- adds two
<link>tags that point AI agents at yourllms.txtand agent discovery file (rel="llms-txt"andrel="agents-json").
It emits no JSON-LD. When you publish an entity, Clione installs a BigCommerce Widget API placement for it, and Stencil renders the @graph into the HTML server-side — so a crawler that runs no JavaScript sees it on the first fetch. Installing the script doesn't put schema on your store, and uninstalling it doesn't take schema off: publishing does both.
Step 1 — Open the tab
Open the store → Store Settings → Schema Injector tab. It shows Installed or Not installed.
Step 2 — Install
Click Install. Clione then:
- Looks for a Clione embed you added by hand. If it finds one, it shows Manual Clione embed detected with Dismiss or Install anyway (force) — two Clione scripts on one page would render twice.
- Reads your channels to see whether the store is Stencil, headless or both. A headless-only store gets the
@clione/seoinstructions and nothing is installed. A store with Stencil plus a headless channel gets the script on Stencil and a note that the headless storefront needs@clione/seo. - Creates a read-only API key for this storefront, restricted to your storefront's hostname. You don't manage it.
- Registers the script through BigCommerce's Scripts API:
location: head,load_method: async,visibility: storefront,consent_category: essential, loading fromhttps://api.clione.ai/api/v1/public/embed/schema-injector/<your-store-id>.js. Because it loads asynchronously, it never holds up your page.
The tab then shows the script's UUID, location, load method, visibility and last-modified date. Refresh status re-reads it, and Open storefront opens your store.
Step 3 — Verify
- Open a published product page in an incognito window and view the source (
Ctrl/Cmd + U). - Search for
data-clione="schema-graph"— that's the server-rendered@graphfrom the Widget API. You can disable JavaScript to prove it doesn't depend on the browser. - On a page with approved FAQs, the accordion appears once the page has loaded.
Preview JSON-LD on the tab shows the store's JSON-LD without leaving the dashboard.
Step 4 — Uninstall
Click Uninstall and confirm (Yes, uninstall). Clione revokes the script's API key and removes the script from BigCommerce. No data is removed on Clione's side; you can install again at any time.
Always uninstall from this tab rather than deleting the script in Script Manager, so Clione's records stay in sync.
BigCommerce — headless / Catalyst
There's nothing to install: your frontend renders its own <head>. Use the @clione/seo SDK or the SEO signals API to fetch the signals and render them server-side. The Schema Injector tab detects a headless channel and shows a ready-to-copy snippet for your framework (Copy snippet).
See Headless on Next.js and the @clione/seo SDK.
Shopify — Online Store (Liquid themes)
On Shopify, the storefront output comes with Clione's own Shopify app, the one you install when you connect Shopify. It adds two app embeds to your theme:
| App embed | What it renders |
|---|---|
| Clione SEO | The JSON-LD @graph in the page <head>, rendered by Liquid on the server: Product on product pages, a collection graph on collections, WebPage on pages, plus FAQPage when the entity has approved FAQs. |
| Clione FAQ | The visible FAQ accordion, rendered from the entity's published FAQ HTML. |
Your meta title and meta description don't need either embed — Shopify renders them natively from the SEO fields Clione publishes to.
Step 1 — Turn on the app embeds
- Shopify admin → Online Store → Themes.
- On your live theme, click Customize.
- In the theme editor, open App embeds (left rail).
- Turn on Clione SEO and Clione FAQ.
- Click Save.
App embeds are per theme: if you switch themes, turn them on again in the new one.
Step 2 — Check it's live
On Shopify, the Schema Injector tab shows Schema Status: it fetches your live storefront the way a crawler would and reports Verified — live on storefront or Not detected, with the URL it checked, the number of schema nodes found and whether the FAQ accordion is present.
- Recheck homepage checks the home page; type a path (for example
/products/your-handle) and click Check this page to check a specific page. - Show JSON-LD shows what it found.
- If it says Not detected, Turn on in theme editor takes you to the right place.
A password-protected storefront can't be checked: the check reaches the password page instead. Remove the password under Online Store → Preferences, or check a store that is publicly visible.
If an entity hasn't been published, there's nothing for the embeds to render on its page — no empty script is output.
Shopify — Hydrogen / headless
There's no theme to add the embeds to. Use the @clione/seo SDK or the SEO signals API from your frontend. See Headless on Hydrogen.
Troubleshooting
BigCommerce
The install fails — The Content scope on your BigCommerce API account is Read-only or None. Set it to Modify (see Connect BigCommerce — Step 3) and click Install again.
The tab says the script is on your storefront but was added outside Clione — Someone added it by hand in Script Manager, or another BigCommerce API account created it. Clione can't manage that copy. Remove it in Script Manager, then install from this tab.
No JSON-LD in page source — The entity hasn't been published. Open it in Clione → Publish tab and publish. Then search page source for data-clione="schema-graph".
No FAQ accordion — Check that the entity has approved FAQs and has been published, and that the script shows Installed.
Shopify
Clione SEO or Clione FAQ doesn't appear under App embeds — Clione's Shopify app isn't installed on this store. Install it from Connect Shopify, then reload the theme editor.
Schema Status says Not detected — Check that Clione SEO is on in your live theme and saved, and that the page you checked belongs to a published entity.
The JSON-LD is there but looks old — The storefront shows what was last published. Publish the entity again after enriching or editing it.
Summary
| Platform | What gets installed | Where | How to remove |
|---|---|---|---|
| BigCommerce Stencil | One script (Clione FAQ Renderer) via the Scripts API | Every storefront page | Uninstall on the Schema Injector tab |
| BigCommerce headless | Nothing — use the SDK | Your frontend | — |
| Shopify Online Store | The Clione SEO and Clione FAQ app embeds of Clione's app | Every storefront page of the theme where they're on | Turn them off in the theme editor |
| Shopify Hydrogen / headless | Nothing — use the SDK | Your frontend | — |