Shopify integration
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:updatewebhook. - 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.
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?
Will it modify products without my permission?
Does it work with Shopify Plus?
What if I uninstall?
Can I use it with a private app instead of the public app?
Ask AI about this page
Open this topic directly in your favourite AI assistant — the prompt is prefilled.
Try this yourself
See eCommerce Insights on your own catalog. The free trial covers your full SKU set across five AI engines, no credit card required.
Start free trial