Connect Shopify
Install both Fabric apps so AI assistants can read your enriched product content.
Only an organization owner can open Settings → Connections or Settings → Publishing.
A published Shopify store uses two Fabric apps, installed in that order. The first writes your enriched content onto your products. The second, Fabric Structured Data, adds that content to the HTML of your product pages, which is what AI assistants read. You need both: content Fabric writes onto a product does not appear in the page's HTML until the second app adds it.
The second app adds your content in two ways. Structured data is hidden in the page and gives AI assistants and search engines your content as labelled facts (step 4). Page text is visible, and shoppers and AI assistants both read it (step 5).
1. Connect your store
This is the app that reads and writes your products. Connecting it asks Shopify for permission to update them, and every publish uses that permission.
You return to Fabric with the card reading Installed. Fabric is verifying the connection, and then your store, the date it connected and its last sync once that check passes.
Note
A greyed-out Connect Shopify button reads "Not enabled for this brand. Ask Fabric to enable Shopify import." Fabric has to register your store with Shopify before you can connect it, so contact Fabric to clear this.
2. Wait for publishing to be enabled
Fabric turns publishing on for your store once the connection above is verified. Until then Settings → Publishing says publishing isn't set up yet, and nothing on your side changes that. Contact Fabric if you expected it to be ready.
3. Choose what Fabric writes
Settings → Publishing controls what a publish may change on your products. By default, Fabric writes only data that shoppers do not see.
| Setting | What a publish writes | Default |
|---|---|---|
| Enriched metadata | Structured data for AI assistants, stored alongside your products. AI assistants read it once steps 4 and 5 add it to your pages. Nothing a shopper reads changes. | On |
| Product fields | Replaces your own copy with Fabric's enriched version. Choose Product description, SEO title and description, or both. | Off |
| Image alt text | Replaces the alt text on your product images. | Off |
Turning off a setting stops the next publish from writing that field. It does not restore what an earlier publish already wrote.
4. Turn on structured data
The Fabric Structured Data app embed adds structured data to the <head> of your product pages.
It has two switches:
| Switch | What it adds | Default |
|---|---|---|
| FAQ schema | Your questions and answers as schema.org FAQPage JSON-LD | On |
| Product schema | A schema.org Product JSON-LD with your enriched description and attributes, plus your store's URL, SKU, price and stock | Off |
Install the app and turn on its app embed. The embed stays off until you turn it on, and the setting is saved per theme, not per store, so installing the app does not turn it on.
If the card asks you to contact Fabric instead of offering an install, the app has not been issued for your store yet.
Turn on Product schema
Turn on Product schema in the app embed so AI assistants get your enriched description and attributes, not only what your theme outputs.
Most themes already output their own Product JSON-LD, built from your product data without
Fabric's enriched attributes. Two Product nodes on one page can cost you Google's product rich
result, so turn your theme's off first. To check whether your theme has one, open a product page,
view the page source and search for "@type":"Product". How you turn it off depends on your theme:
some have a setting for it, others need a developer to remove it from the product template.
On a product Fabric has not enriched yet, Product schema writes a basic node from your store's own title, description, vendor, SKU, price and stock, so the page is never left without one.
Note
Publishing a new theme turns the app embed off. App embeds are saved per theme, so turn it on in the new theme before you publish it.
5. Show your enriched content on the product page
Fabric's app blocks write your enriched content into the body of the product page as text. Shopify renders them on the server, so the content is in the page source that AI assistants read, and shoppers see it on the page. Add the Fabric Specs & FAQ block:
It shows specifications and the questions and answers Fabric wrote, as collapsible sections you can set to open all, first-only or closed. Product details are a third section, off until you turn it on, because most themes already show your description. It shows Fabric's enriched description, or your own on a product Fabric has not enriched yet. Keep FAQ schema turned on in the app embed as well, so the page text and the structured data match.
Note
Fabric Specs & FAQ replaces the older Fabric Specifications and Fabric FAQ blocks. If either is still on the template, remove it or its content appears twice.
6. Check that it worked
Select products in Catalog and choose Publish, then open one of the products you published and view the page source. Use view source rather than your browser's inspector: the page source is what AI assistants read.
| You turned on | Search the page source for |
|---|---|
| FAQ schema | data-fabric-structured-data="faq" |
| Product schema | data-fabric-structured-data="product", or "product_fallback" on a product Fabric has not enriched |
| The Fabric Specs & FAQ block | its section headings and a few of your questions |
No Fabric tag means the app embed is off in the published theme, or that product has no enriched
content yet. Fabric cannot read your theme, so the page source is the only place to check this.
The Schema Markup Validator on the same URL should list your
FAQPage, and your Product when Product schema is on, with no errors.
Every publish a brand has run is listed under Catalog → Publish history, with what each one wrote, skipped and failed.
Related
- Destinations: what else you can publish to, and who has to approve it.
- Publishing over the API: run the same publish from your own code.