Shopify Integration

Overview

The Shopify integration connects Omni to your store's products, orders, customers, returns and catalogue signals. Once connected, Omni can answer store questions, support customers with live order context, and prepare Shopify operations for review.

Advanced Shopify operation claims need live test-shop evidence before they are treated as production-ready. The current safe modes were certified against the connected test shop on 2026-06-16: previews, read-only audits, paid-order reads, public storefront diagnostics and one narrow metafield write with read-back and cleanup.

That certification does not include automatic theme publishing, checkout deployment, app patching, email automation publishing or migration execution. Those stay manual-review until rollback paths are proven.

For the full capability list, see Shopify Operations.

Prerequisites

• A Shopify store
• Store owner or staff access with permission to manage apps
• Permission to connect the store to Omniops

Setup

Install through the Shopify app flow

If you are installing Omniops through Shopify, follow the guided setup. Shopify handles the secure app connection, then Omniops asks you to link or create the right organisation.

After setup, check Integrations in Omniops to confirm Shopify shows as connected.

Connect manually with an Admin API token

If you are connecting manually:

1. In Shopify Admin, go to Settings > Apps and sales channels > Develop apps
2. Create an app for Omniops
3. Add the permissions shown in the Omniops setup screen
4. Install the app and copy the Admin API access token
5. In Omniops, go to Integrations → Shopify
6. Enter your Shopify store domain and paste the token

Use the permissions shown in-product as the source of truth, because the exact scope list can change as new Shopify features become available.

What Shopify enables

Once connected, you can ask Omni about:

• Order status, tracking, fulfilment and returns
• Revenue, order volume, top products and customer history
• Product catalogue issues, missing SEO fields and stock problems
• Test-shop verified bulk SEO previews and approval-led SEO apply lanes
• Metafield update previews, plus a narrow confirmed-write pattern with Shopify read-back
• Drafts for product copy, post-purchase flows, Liquid sections and checkout offers

Safety model

Omni treats Shopify work by risk level:

Status	What it means
live	Omni can read Shopify data without changing your store.
approval-required	Omni prepares the change and waits for approval before a supported write.
confirmed-write	A narrow write pattern with old/new values, capped confirmation, Shopify read-back and cleanup evidence. Today this is proven for a one-product metafield update path.
preview-only	Omni drafts or diagnoses the work, but does not write to Shopify.

Theme, checkout, app-conflict and migration work stays manual-review until rollback paths are proven.

Troubleshooting

Shopify is not connected

• Confirm the store domain is correct
• Check that the app is installed and active in Shopify
• Reconnect if Shopify says a required permission is missing

Data looks incomplete

• New stores may need a short first sync
• Some historic data depends on the permissions granted during setup
• Draft or unpublished data may not appear in every report

A write is blocked

This is usually intentional. Omni blocks risky Shopify changes unless the right approval, confirmation, read-back or rollback path exists.