Integrations · Shopify

Shopify integration

Updated 2026-05-25 Integration eCommerce Insights team

The Shopify integration is the deepest of eCommerce Insights's connectors. It imports your full catalogue including metafields, audits in response to product:update webhooks, and pushes approved Listing rewrites back to Shopify via the admin API. This page walks the install, the scopes, and the publishing model.

What it does

Three jobs.

Import your full Shopify catalogue, including metafields, into eCommerce Insights on a one-click install.
Re-audit any SKU automatically when Shopify fires a product:update webhook.
Push approved Listing rewrite capsules back to Shopify via the admin API.

Install

Find the listing
Search "eCommerce Insights" in the Shopify App Store, or click Install from Settings → Integrations inside eCommerce Insights.
Review scopes
Shopify surfaces the scope list before you confirm. See below.
Confirm
Shopify redirects back to eCommerce Insights; catalogue import begins automatically.
Initial sync
Under 5 minutes for catalogues under 1,000 SKUs. Larger catalogues run in batches.
First audit
The Products table populates with channel-resolved scores. Click any SKU to drill in.

Required scopes

Scope	Why	Required?
read_products	Catalogue import.	Yes
write_products	Push approved Listing rewrites.	Yes
read_metafields	Read existing metafields used for PDP rendering.	Yes
write_metafields	Write eCommerce Insights-managed metafields (in the `ecommerceinsights` namespace).	Yes
read_orders	SKU-level AI-referral attribution. Used only if you opt into attribution.	Optional

Catalogue import

The initial import pulls per product: title, body HTML, vendor, product type, tags, handle, status, published_at, variants (with SKU, price, inventory state), images (with alt text), and the full metafield namespace. Imported products are deduped against any prior CSV upload.

Webhook-driven re-audits

On install, eCommerce Insights registers webhooks for products/create, products/update, and products/delete. When a webhook fires:

products/create — new SKU added to the catalogue and queued for first audit.
products/update — existing SKU's data refreshed; the SKU is queued for re-audit. Most score drift is caught this way.
products/delete — SKU archived in eCommerce Insights. Historical data retained for 30 days.

Publishing approved diffs

Approved Listing rewrite capsules ship to Shopify via the admin API. Push is triggered explicitly — from the Approved queue, click "Push selected" or "Push all." Per-SKU errors are surfaced with the full Shopify response body; successful pushes move to History.

Important eCommerce Insights does not auto-publish. Every push requires an explicit user action. This is by design — a wrong rewrite at scale is more painful than a missed week.

Metafields

eCommerce Insights-managed metafields use the ecommerceinsights namespace so they do not collide with anything your theme or apps use. Two metafields are written by default:

ecommerceinsights.faq_block — the FAQ Q&A pairs as JSON, consumed by themes that render FAQ schema on the storefront.
ecommerceinsights.ai_summary — a 2-3 sentence AI-friendly summary of the product, useful for theme blocks rendered above the description.

Additional metafields can be configured in Settings → Integrations → Shopify → Metafields.

Common questions

Is the Shopify integration available for all plans?

Yes. The integration is included in every plan, including the free trial.

Will it modify products without my permission?

No. Push to Shopify happens only when you click Approve on a Listing rewrite capsule. Even after approval, you can review the queue before triggering the actual push.

Does it work with Shopify Plus?

Yes, including multi-store Plus organisations. Each store is a separate workspace in eCommerce Insights.

What if I uninstall?

Your data stays in eCommerce Insights for 30 days, then is auto-deleted. Reinstalling within 30 days restores everything.

Can I use it with a private app instead of the public app?

Yes for self-hosted eCommerce Insights instances. Public eCommerce Insights uses the public app exclusively.

Ask AI about this page

Open this topic directly in your favourite AI assistant — the prompt is prefilled.

Was this page helpful?

Thanks — recorded.

Integration →

WooCommerce

For non-Shopify stores.

Feature →

Listing rewrite

The feature whose output the integration publishes.

Try this yourself

See eCommerce Insights on your own catalog. The free trial covers your full SKU set across five AI engines.

Start free trial

LLM-friendly summary of this page

Shopify integration is eCommerce Insights's deepest connector. Install via Shopify App Store. Required scopes: read_products, write_products, read_metafields, write_metafields, read_orders (last is optional, for AI-referral attribution). Initial catalogue sync under 5 minutes for <1000 SKUs; larger catalogues batch in background. Includes title, description, SKU, variant, price, images, metafields, tags, vendor, product type. Webhook-driven re-audits: product:update webhook triggers an asynchronous re-audit of the SKU. Publishing model: approved Listing rewrite capsules push to Shopify via admin API; one-click bulk push from the Approved queue; per-SKU errors surfaced with response body. Metafield writes go to a namespace 'ecommerceinsights' so they do not conflict with existing namespaces. Available on every plan including free trial. Shopify Plus supported including multi-store. Uninstall keeps data for 30 days then auto-deletes. Self-hosted instances can use a private app.