Connect your Shopify store
Quick Reference
Inputs
Admin rights on your MarginOS workspace, permission to install apps on the Shopify store, and a store not already claimed by another workspace.
Outputs
A read-only connection syncing orders, products, customers, refunds and order source data, plus a first sync that pulls your order history rather than only recent orders.
Outcomes
Get revenue and product-level profitability flowing on day one, and understand why margins read high until real product costs are supplied.
Connecting Shopify is the first thing you do in MarginOS and the only connection that is strictly required. It installs the MarginOS app from the Shopify App Store, which brings across your orders, products, customers and refunds — the raw material every profit figure is built from.
The permissions requested are read-only, and connecting puts you on the free plan with no charge and no credit card.
Before you start
- You need an account with admin rights on the MarginOS side. Setup is restricted to admins.
- You need permission to install apps on the Shopify store you are connecting.
- A store can only be claimed once. If it is already connected to another MarginOS workspace, you will be told rather than silently attached — see the troubleshooting section.
How to connect
- Open the connection step — either during Express Setup, where it is step 2 (“Connect your data”), or later from your integrations settings.
- Click Connect Store. This takes you to the MarginOS listing on the Shopify App Store.
- Install the app and review the permissions Shopify shows you. They are read-only: MarginOS requests only the access needed to build your profit view, and cannot change orders, products, inventory or anything else in your store.
- Approve. Shopify returns you to MarginOS, which confirms with Connection Successful and begins syncing.
There is no API key to generate, paste or store. The connection is made through Shopify’s own authorisation flow, so your credentials are never handled by MarginOS.
What MarginOS reads, and why each part matters
| What it reads | What it is used for |
|---|---|
| Orders | Revenue, discounts, shipping charged and payment fees — the top of every profit figure |
| Products and variants | The catalogue each cost attaches to, and the unit of SKU-level margin |
| Customers | Cohorts — which customer was acquired when, and by which channel |
| Refunds and returns | Reversing revenue and, where stock comes back, the product cost with it |
| Order source and referral data | Assigning each order to an acquisition channel |
What it does not read is anything it does not need, and it holds no write access at all.
What happens after you connect
The first sync pulls your history, so it takes longer than later updates and the size of your store decides how long. You do not need to wait on the page.
Figures fill in as the data lands. Revenue appears first because it comes straight from your orders. Margins will look wrong until costs arrive — with no product costs, MarginOS has nothing to subtract, so early profit numbers read high. That is expected, and it is the reason the next step matters more than it sounds:
- Set your store-wide cost defaults so every product has something to fall back on.
- Then supply real per-item costs, which is what moves you from an estimate to an evidenced margin — see the Defensible Profit Model.
Connecting an ad platform later adds acquisition cost on top, which is what unlocks CAC and the ratios built on it. Shopify alone gives you revenue and product profitability; it cannot tell you what customers cost to acquire.
Common questions
Can MarginOS change anything in my store?
No. The permissions requested are read-only, and MarginOS holds no write access to orders, products, inventory, customers or settings. It reads and calculates; it does not act on your store.
Does connecting cost anything?
No. Connecting puts you on the free plan with full access, no recurring charge and no credit card required.
I get “this Shopify store is already connected”. What now?
The store has been claimed by another MarginOS workspace — usually a colleague’s, or an earlier trial of your own. A store belongs to exactly one workspace so two sets of numbers can never disagree about the same orders. Get an invitation to the workspace that holds it, or have that workspace release the store.
How far back does it import?
The first sync pulls your order history, not just recent orders, because cohort measures need customers’ full lifetimes to be meaningful. Metrics that depend on a window of history become available as enough of it lands.
My orders are in but my margins look far too high. Is it broken?
Almost certainly not — it is the expected state before costs exist. Revenue comes from Shopify; product costs do not. Until you supply them, MarginOS has little to subtract. Data Trust shows which products are running on evidence and which are not.
Do I need to reconnect if I change my Shopify plan or domain?
Not for a plan change. If the connection stops updating after a store change, reconnect from your integrations settings — the flow is the same and your history is preserved.
Related
- Set your store-wide cost defaults — the next step after connecting.
- The Defensible Profit Model — how MarginOS grades the cost evidence behind a margin.
- How MarginOS assigns each order to a channel — what it does with the order source data.
- How MarginOS turns raw data into your margins — what happens to everything it reads.
About the author
Aron Baczoni is the founder of MarginOS and a former decade-long veteran of Google's Ads and Global Business Operations units. His work is focused on bridging the gap between AI's promise and its practical implementation for direct-to-consumer (DTC) brands, helping them build a sustainable competitive advantage through strategic, high-ROI AI solutions.
Read Aron's story