Why do I need to enable a theme app embed?

Shopify requires apps to add storefront code through theme app extensions rather than editing your theme files directly. The embed is how Navaal publishes FAQPage structured data to your product pages without touching your theme code. It is off by default and you enable it once.

Nothing appears in my page source. What is wrong?

Check three things. First, the embed must be enabled on your published theme, not a draft. Second, you must have clicked Save in the theme editor. Third, the product you are viewing must have FAQ content that you have published in Navaal — the embed only outputs schema for products that have it.

Does the embed slow down my storefront?

No. It outputs a small block of JSON-LD text into the page head. It loads no external scripts, no fonts, and no images, and it does not change how your product page looks.

I changed themes. Do I need to do this again?

Yes. App embeds are configured per theme, so you need to enable it again on any new theme you publish.

Will FAQ schema guarantee rich results or AI citations?

No. Structured data makes your content machine-readable, which is a prerequisite for being parsed and cited. Whether any search engine or AI answer engine displays or cites it is their decision, and no tool can guarantee it.

// Docs

Enable the
FAQ schema embed.

Navaal publishes FAQ structured data to your storefront through a Shopify theme app embed. It is off by default. Here is how to turn it on, and how to verify it is working.

// Why this step exists

One toggle, once.

Shopify requires apps to add storefront code through theme app extensions rather than editing your theme files. That is a good thing — it means Navaal never touches your theme code and nothing breaks when you switch themes.

The trade-off is that the embed ships off by default. Until you turn it on, Navaal generates and stores your FAQ content, but that structured data does not reach your live storefront.

// Before you start

You need FAQ content published

Generate FAQ content for at least one product in Navaal and publish it through Review & Publish. The embed only outputs schema for products that have published FAQ content.

Takes about 30 seconds. You only do this once per theme.

// Steps

Enable the embed.

Open your theme editor

In your Shopify admin, go to Online Store → Themes, then click Customize on your published theme.

Open App embeds

In the left sidebar of the theme editor, click the App embeds icon — it is the puzzle-piece icon near the bottom.

Turn on “AI-search FAQ schema”

Find AI-search FAQ schema in the list and switch the toggle on.

Save

Click Save in the top right. That is it — structured data now publishes to your product pages.

// Shortcut

Open the theme editor directly

Replace YOUR-STORE with your store domain and open this URL — it lands you straight on the App embeds panel:

https://YOUR-STORE.myshopify.com/admin/themes/current/editor?context=apps

Navaal also links you here directly from the setup card on your dashboard.

// Verify

Confirm it is live.

Do not take our word for it — check the page yourself. This takes a minute.

Open a product page on your live storefront

Pick a product you have published FAQ content for in Navaal.

View the page source

Right-click the page and choose View page source, then search the page for FAQPage.

You should see a JSON-LD block

Something like <script type="application/ld+json">{"@context":"https://schema.org","@type":"FAQPage",…}</script>

Validate it properly

Paste the product URL into Google’s Rich Results Test. It should detect FAQ structured data with no errors.

// Troubleshooting

If it is not showing.

Nothing appears in my page source

Check three things, in order. One: the embed must be enabled on your published theme, not a draft copy. Two: you must have clicked Save in the theme editor. Three: the product you are viewing must have FAQ content that you published in Navaal — the embed only outputs schema for products that have it.

The Rich Results Test finds nothing

Make sure you are testing a product URL, not your homepage or a collection page. The FAQ schema is published on product templates. If the page source contains the JSON-LD block but the test does not detect it, check that the product page is publicly accessible — a password-protected development store cannot be crawled.

I switched themes and it stopped working

App embeds are configured per theme. Enable it again on your new published theme using the steps above.

Does this slow my store down?

No. It writes a small block of JSON-LD text into the page head. No external scripts, no fonts, no images, and no visual change to your product page.

Will this guarantee rich results or AI citations?

No, and be wary of anyone who says otherwise. Structured data makes your content machine-readable, which is a prerequisite for being parsed and cited. Whether Google shows a rich result, or ChatGPT cites you, is their decision. What you control is whether your content is readable and worth citing.

Still stuck?

Email a human at [email protected]. Include your .myshopify.com domain and a screenshot — we reply within one business day (AEST).

Email support →

Enable theFAQ schema embed.