Shopify App Onboarding: A 7-Step Guide for Getting Merchants Set Up (2026)

This guide covers the seven steps that matter most, how to onboard merchants who are not technical, and how onboarding calls, help docs, product tours and AI onboarding agents compare.

Obi is Cor's AI onboarding agent for B2B software companies. It works directly with customers, sees their screen in real time, and guides them through setup, integrations, implementation, and product training.

Why Shopify app onboarding is hard

Most merchants find apps in an app store and install on their own. They never talk to your team. If setup is not done in the first session, many never come back.

Much of the setup also happens outside your app: in the store admin, the theme editor and other apps the merchant uses.

The 7 steps to onboard Shopify merchants

1. Start onboarding at the moment of install

The first minutes after install are when the merchant is most motivated. Put the setup path, or a way to start a guided session, right on the welcome screen.

2. Get to one visible result on the storefront

Ask what the merchant wants live first: a widget, an offer, a synced catalog. Seeing it on their own store is what makes them keep the app.

3. Guide the theme install step by step

Adding the app block or embed to the theme is where many merchants get lost. Show them exactly where it goes in their theme editor, and check the storefront together.

4. Sync the catalog and check it

Product and catalog syncs can fail quietly. Confirm the right products came through before building rules on top of them.

5. Connect the tools they already use

Email platforms, reviews, payments and shipping tools often need to connect. Treat each connection as its own guided step.

6. Set rules with sensible defaults, then customize

Offers, rewards, placements and automations are easier to adjust than to create from nothing. Start from defaults and change them with the merchant.

7. Cover every time zone

Merchants install from everywhere, at every hour. Onboarding that only works in your office hours misses most of them.

How to onboard merchants who aren't technical

Show them where things are in their own store admin rather than describing it. Keep each session to one visible result. Avoid developer terms. And give them a way to ask "why isn't it showing?" at the moment it happens, not in a support ticket two days later.

Onboarding calls vs help docs vs product tours vs AI onboarding agents

Onboarding calls with a person work well for large brands and Shopify Plus stores. They do not scale to thousands of self-serve installs.

Help docs and videos are cheap and always available. They cannot see the merchant's theme, which is often where the problem is.

Product tours and checklists point merchants around your app. They work inside your app but stop at the edge of it, so they cannot help in the theme editor or store admin.

AI onboarding agents run the guided session itself. The merchant shares their screen, the agent learns their goal, walks them through your app, the store admin and the theme editor by voice and chat, answers questions from your docs, and hands off to your team when a theme needs a developer. They cover every install at any hour, and they are only as good as the docs they learn from.

Most Shopify app companies use a mix: people for large merchants, an agent or in-app guidance for self-serve installs, and docs for reference.

Example: a merchant adds a loyalty widget

A merchant installs a loyalty app and starts a guided session from the welcome screen. They want the widget on their product pages today. The agent sees the app is installed but the widget is not in the theme. It guides the merchant into the theme editor, shows where the block goes, and checks the storefront with them. Then it walks them through connecting their email platform so reward emails go out. The merchant finishes setup in the same sitting they installed.