Shopify Integration

The Shopify integration connects a workspace to a Shopify store via OAuth. Two-way data flow: products sync into Lumio for scoring and enrichment, and enriched content pushes back as product metafields. A theme extension renders the metafield data as Schema.org JSON-LD on the storefront.

Connecting a store

Open Integrations in the sidebar and click Connect Shopify. Enter the *.myshopify.com domain. Lumio creates a scoped OAuth state token, redirects to Shopify for authorization, and exchanges the returned code for access tokens.

Required Shopify scopes:

• read_products — read the catalog for import and scoring
• write_products — write enrichments back as product metafields
• read_orders — read access to orders, requested at install

Connect, import, and push operations all require an owner or admin role in the Lumio organization.

Once connected, the store domain and connection status appear on the Integrations page.

Syncing products

After connecting, open Catalog, choose the Shopify Import tab, and click Import from Shopify. Lumio runs a Shopify bulk export (the GraphQL Bulk Operations API), polls until it completes, and downloads the full product set as a single file — variants, pricing, images, and metadata all come through. Reading Shopify’s data directly is faster and more complete than scraping storefront pages.

The import runs as a background job. The previous active catalog is archived (not deleted) before the import starts. If it fails, the archived catalog is restored automatically. Scoring and enrichment history on archived catalogs is preserved.

Scoring and enriching

Score and enrich Shopify-sourced products the same way as sitemap-sourced products. From AI Scores, run scoring to identify gaps. From Enrichments, generate optimized content shaped by the brand profile and voice rules.

Delivering enrichments

After enrichment, the Push enrichments to Shopify action writes the enriched fields to product metafields. Push progress streams as each batch completes. This lives in the Distribution area, which is still rolling out — it’s marked Soon in the sidebar.

The metafield payload includes the enriched fields (title, description, Q&A, attributes) — not a complete JSON-LD blob. The theme extension merges the metafield data with live Shopify data (price, availability, variant info) at render time, so the storefront always shows current information.

Oversized payloads are skipped with a clear message rather than failing the whole push. A feed record captures the results: succeeded, failed, skipped counts.

Pushing requires the delivery feature, included on Professional and Elite plans.

Validating the storefront

After a push, click Validate on a product to confirm everything’s rendering correctly. Lumio fetches the live product page and reports:

• How many JSON-LD blocks are present
• Whether Product type is detected
• Which enriched fields are visible
• Whether duplicate Product blocks exist (a common storefront issue)

Theme extension

The Lumio theme extension is what renders the metafield data as JSON-LD on the storefront. Install it from the Lumio app’s installation flow inside Shopify, then enable it in the Shopify theme editor’s app embeds. Without the extension installed and enabled, the metafields exist on products but never reach the page.

GDPR webhooks

Lumio implements Shopify’s mandatory GDPR webhooks (customers/redact, shop/redact, customers/data_request) with HMAC-SHA256 signature verification. These are declared in the app configuration and managed by Shopify — there’s no per-store registration step and no additional setup.

Disconnecting

In Integrations, click Disconnect. Lumio deletes the stored connection and its access token, and unlinks the catalog from the integration. Existing metafields stay on products until removed manually in Shopify admin. To fully revoke access, uninstall the Lumio app from the Shopify admin.

Requirements

• A *.myshopify.com domain
• Owner or admin role in the Lumio organization for connect, import, and push
• The delivery feature (Professional plan and above) for Push enrichments to Shopify
• The Lumio theme extension installed and enabled in the Shopify theme for JSON-LD to appear on the storefront