Connect Shopify — MerchantFlow

Connect Shopify to MerchantFlow

The Shopify integration connects your Shopify store to MerchantFlow via OAuth, enabling automatic syncing of orders, products, inventory, and customer data for profitability analysis and reporting. This guide covers the web app connection flow -- if you installed MerchantFlow from the Shopify App Store, see Shopify App Store instead.

What Is the Shopify Integration?

MerchantFlow's Shopify integration is a read-only OAuth connection that pulls commerce data from your Shopify store into MerchantFlow. Once connected, MerchantFlow syncs your orders, products, inventory levels, analytics, and reports to power dashboards, P&L tracking, and product-level profitability views.

What You Need

Before connecting, make sure you have:

• MerchantFlow owner or admin access (check your role)
• Verified email and two-factor authentication enabled on your MerchantFlow account
• Admin access to the target Shopify store
• The store's .myshopify.com domain (e.g., your-store.myshopify.com)

How to Connect Shopify

1. Open /onboarding/commerce or navigate to Settings > Integrations
2. Choose Shopify
3. Enter your .myshopify.com store domain
4. Approve the Shopify OAuth request -- this grants MerchantFlow read-only access to orders, products, inventory, analytics, reports, and customer-linked commerce data
5. Return to MerchantFlow to confirm the connection

After connecting, MerchantFlow begins your first sync automatically.

Shopify Scopes Requested

MerchantFlow asks Shopify for exactly these access scopes, and every one of them is a read scope:

• read_orders and read_all_orders -- order history beyond Shopify's default 60-day window
• read_products -- product catalog, variants, and pricing
• read_inventory and read_locations -- stock levels and warehouse locations
• read_analytics and read_reports -- Shopify-native analytics
• read_customers -- customer records linked to orders for LTV and attribution

Important Platform Rules

• MerchantFlow supports one primary commerce platform per merchant tenant
• If WooCommerce is already connected, you must disconnect or replace it before Shopify becomes the active commerce platform
• Once a real commerce platform is connected, the workspace leaves demo mode

What Data Does MerchantFlow Sync from Shopify?

MerchantFlow syncs the following from your Shopify store:

• Orders -- revenue, refunds, and transaction details
• Products -- SKUs, variants, pricing, and inventory levels
• Analytics and reports -- Shopify-native analytics data
• Customer commerce data -- linked to attribution and profitability views

All data is read-only. MerchantFlow never modifies your Shopify store.

Disconnecting and Reconnecting

Disconnecting Shopify from Settings > Integrations stops MerchantFlow syncing your store, but it does not delete your account, your history, or the link between your store and your workspace.

Reconnecting -- whether from Settings or by reinstalling from the Shopify App Store -- returns you to the same workspace, with your orders, products, costs, and reports intact. You are not charged again for reconnecting, and reconnecting your own store never counts as adding a second store, so a one-store plan does not need to upgrade.

The same applies after uninstalling the app from your Shopify admin: reinstalling picks up where you left off. If you had already paid for a subscription period, that time is honoured -- MerchantFlow restores your access for the remainder of the term rather than asking you to buy it again.

If a reinstall ever asks you to upgrade to Plus for a store you already had connected, do not upgrade. Contact [email protected] and we will relink it without any change to your plan.

Troubleshooting Shopify Connection Issues

If Shopify does not connect:

• Confirm the store domain is a valid .myshopify.com address
• Confirm the MerchantFlow user has verified email and 2FA enabled (Security Settings)
• Confirm you are approving the correct store in Shopify
• If a reinstall asks you to upgrade to Plus for a store you already had connected, contact [email protected] rather than upgrading
• Check the Troubleshooting Integrations guide for additional steps

Frequently Asked Questions

Can I connect multiple Shopify stores?

Each MerchantFlow merchant tenant connects to one Shopify store, but a Plus workspace can link up to five stores together. Open Dashboard > Stores > Manage Stores and click Add another store -- the linked store shares your plan, with no extra subscription, and you approve the install in that store's Shopify admin. Starter and Pro are limited to one store.

If you would rather keep stores fully separate, use separate merchant workspaces or an agency workspace.

Does MerchantFlow write data back to Shopify?

No. The Shopify OAuth connection is read-only. MerchantFlow pulls data for analytics and reporting but never creates, updates, or deletes anything in your Shopify store.

How often does MerchantFlow sync with Shopify?

MerchantFlow schedules one recurring background delta sync per workspace, which covers every connected integration in a single pass. The default cadence is every 30 minutes; the exact interval is set per environment. You can also trigger a manual sync at any time from Settings > Integrations.

How far back does a sync go?

There is no fixed history window. Both your first sync and any full resync ask Shopify for the date of your oldest order and start the window seven days before it, so a store with four years of orders gets four years of history on the first pass. The 90-day figure you may see referenced is only a fallback for when no orders can be found at all.

Routine delta syncs are incremental -- they resume from the last successful sync with one day of overlap for safety.

A five-year bound does apply in a couple of narrower places: the product catalog pulls five years on a full sync (90 days on a delta), and the ad-spend gap repair that backfills missed days looks back at most five years on a full sync (60 days on a delta).

Related Guides

• Connect Integrations -- full onboarding walkthrough
• Shopify App Store -- install via the Shopify App Store
• Shopify Billing -- billing for App Store installs
• WooCommerce -- alternative commerce platform
• Sync Status -- monitor sync health
• Sync Troubleshooting -- fix sync issues

---

Last updated: August 29, 2026