Install Commander and start your setup
You install Commander from Shopify and open it inside Shopify Admin. The first time you open it, Commander shows a short welcome screen. You answer two questions and press Start your setup.
Before you install
You need a Shopify store. Commander runs inside Shopify Admin, so your store connects when you install. You do not connect it again later.
Shopify shows a permission screen when you install. It lists every permission in full. In plain words, Commander asks to read the following:
| Area | What Commander reads it for |
|---|---|
| Products | Your product catalog. |
| Orders | Your orders. Commander asks for your full order history, not only recent orders. |
| Customers | Your customer list, to build customer segments. |
| Analytics and reports | Store analytics and Shopify's sales report, to rank your best sellers. |
| Themes | Details of your theme. |
Commander also asks to write to your store: customer tags and metafields, pages, files and URL redirects. Read the Shopify permission screen before you accept.
Open Commander for the first time
Open Commander in Shopify Admin. Commander does not open the dashboard yet. It opens a screen that says Welcome to Commander.
The card under the heading shows your store name, your store domain, the Connected badge, your timezone and your currency. Commander reads these from Shopify. You cannot change them on this screen. Your brand name starts from your Shopify store name. You can rename your brand later in Settings > General.
A short message tells you that Commander is about to read your products, orders and reviews. The fields appear when the message ends.
Answer the two questions
- Open Industry (optional). Pick the closest match, or keep the first option, Skip — work it out from my products.
- Check Average product margin (%). Change the number if you know your own margin.
Industry. Commander checks your Shopify product categories first. If the check takes more than a moment, the two fields lock and the hint reads Checking what your Shopify products say you sell…. If Commander finds a match, it selects the industry and says so: I read this from your Shopify product categories. Change it if I got it wrong. If it finds no match, the field stays on the skip option. If you skip the field, Commander works out your industry from your products after they import.
Average product margin (%). This is your gross margin: sales minus product cost, as a percentage of sales. Count it before shipping, payment fees and ad spend. The first line under the field says the same. Commander fills in a typical starting figure for the industry you pick. The second line under the field says which. A ballpark is enough. Commander uses this figure to turn revenue into profit in the numbers it reports. A figure you type is never overwritten when you pick an industry later.
Start your setup
Press Start your setup. The button reads Starting… while Commander sets up your workspace and begins to import your store. The import runs in the background, and the setup wizard opens straight away.
If setup fails for another reason, a red banner titled Setup failed shows the message. Press Start your setup again.
Setup uses no credits.
If you already use Commander for this store
You may already have a Commander workspace for this store, for example one you set up in the Commander web app, outside Shopify Admin. When you press Start your setup, Commander looks for it. Commander connects your store to that workspace only when it can confirm that the workspace is yours and that it is set up for your store domain. Commander can confirm it when you sign in to that workspace with Google, with the same email as your Shopify staff account, and you are its only member.
When Commander does not connect your store to it, Commander creates a new workspace for your store. Your other workspace stays as it is. To join the two, contact support. See Contact support.
If you sign in to the Commander web app with an email and a password, and Shopify has verified the same email for your Shopify staff account, opening Commander in Shopify Admin turns off that password and signs you out of the web app. After that, open Commander from Shopify Admin, or sign in to the web app with Continue with Google and the same email.
If Commander says your Shopify store email is missing
A red banner titled Shopify store email is missing means Commander could not read a contact email from Shopify. Setup cannot start until your store has one.
- Open Shopify Admin and go to Settings > Store details.
- Enter a store contact email and save it.
- Return to Commander and reload the page.
- Press Start your setup again.
If setup stopped halfway
You may see a warning banner titled Finish setting up your store. It means Commander saved your store details, but setup did not finish the last time. The agent message reads Let’s pick this back up. Check the two answers and press Start your setup again. Until setup completes, your insights stay generic.
If you see "We couldn't connect to Commander"
Your store is installed and nothing is lost. Commander could not load your account at that moment. This is a connection problem, not a setup problem.
- Press Try again. The button reads Retrying… while it works.
- If the error stays, press Reload.
- If it still stays, close Commander and open it again from Shopify Admin.
If you contact support, copy the line after Details: into your message. It helps the support team find the cause. See Contact support.
What happens next
After you press Start your setup, the wizard opens. It asks a few questions while your data imports. Continue with The setup wizard.