Shopify app onboarding: turning installs into paying merchants

Shopify app installs turn into paying merchants when more of them activate, see the app working on their own store, before their free trial ends. Four moves matter most, in our experience:

1. Define one activation moment.
2. Remove the steps in front of it.
3. Put help on the screens where setup breaks.
4. Contact merchants who have not activated within one to two days.

An install that never activates can be a major leak in a Shopify app, because the merchant leaves before seeing what the app does.

This guide covers how to define and measure activation, where onboarding usually breaks, how trials affect conversion, and how support fits into the first session.

What is activation for a Shopify app?

Activation is the first moment a merchant sees your app do the job they installed it for, on their own store. It differs by app category:

Pick one action, make it something you can detect in your own data, and avoid choosing “finished the setup wizard”. A merchant can finish your wizard and still never see the app work.

How do you measure onboarding?

Measure onboarding with three numbers, tracked by the week merchants installed:

For example, if 200 merchants install in a week, 90 activate within 7 days and 40 are paying when their trials end, the activation rate is 45 percent and the install-to-paid rate is 20 percent. Shopify’s Partner Dashboard shows installs, uninstalls and time to uninstall for each app (shopify.dev, checked 1 October 2026), but activation is something only your app knows, so you need to record it yourself.

Compare the two rates. If activation is low, onboarding is the problem. If activation is healthy but few merchants pay, the problem is more likely value, pricing or the trial. As a working heuristic of ours, not a benchmark: if fewer than half of installs activate, start with onboarding before you touch pricing.

Where do Shopify app onboarding flows usually break?

In our experience, Shopify app onboarding commonly breaks at the points where the merchant has to make a decision or leave your app to do something. These are general patterns, not Shopify requirements:

1. The permission screen. Merchants are asked to approve access to their store, and a long or alarming list of scopes makes some stop there. Ask only for the access your app needs.
2. Choosing a plan. A pricing screen before the merchant has seen the app work asks them to pay for something they do not understand yet.
3. The first configuration. Settings with no defaults force the merchant to make decisions they are not ready to make.
4. Turning the app on in the theme. Apps that need an embed or block enabled in the theme editor send merchants out of your app, and some do not return. Check your own data to see how many.
5. Waiting for data. If the app shows nothing until real orders or customers arrive, the merchant has nothing to look at in the first session.

Your own data will show which of these is your biggest drop. Look at where merchants who never activated stopped.

Why do merchants uninstall during onboarding?

Merchants uninstall during onboarding when something gets in the way before they see the app work. The causes line up with the break points above:

Shopify’s Partner Dashboard shows time to uninstall for each app, so you can see whether merchants leave in the first days, which points to onboarding, or later.

How do you design the first session?

Design the first session backward from activation: start with the moment the app works, then remove or shorten every step in front of it.

• Use sensible defaults, so the app works before the merchant changes anything.
• Show the result early. A preview, a sample bundle or a test booking lets the merchant see the outcome before they configure everything.
• Delay what can wait. Advanced settings, integrations and branding can come after activation.
• Write the next step on every screen, in one sentence, so a merchant who returns tomorrow knows where they left off.

A good test is to install your own app on a fresh development store and count the clicks and decisions between install and activation. Every one you remove helps.

What should the first screen after install show?

The first screen after install should show the merchant one clear next step toward activation, and nothing that competes with it. Merchants arrive from the App Store with a single question: will this do what the listing promised for my store? The first screen should answer it.

A strong first screen has three parts:

1. A one-line promise, in the merchant’s words, matching the App Store listing they just read.
2. One primary action that leads straight toward activation, such as “Create your first bundle” or “Set up your booking page”.
3. A visible way to get help, such as a chat button or a two-minute video, for merchants who hesitate.

Leave dashboards, empty charts and settings for later. An empty dashboard on the first screen tells the merchant nothing has happened yet, which is the opposite of what you want them to feel.

What should your onboarding help center contain?

Your onboarding help center should answer the questions merchants ask before they activate, in the order they ask them. Five articles cover most of it:

1. Getting started: the steps from install to activation, with screenshots.
2. Turning the app on in your theme, if your app needs an embed or block enabled.
3. Choosing a plan: what each plan includes, and what happens when the trial ends.
4. Common setup problems: the three or four things that most often go wrong, and the fix for each.
5. How to get help: where to chat, and when you reply.

Write each article from real support conversations, using the merchant’s words for the problem. The guide to building a help center for a Shopify app covers structure and search.

How long should a Shopify app free trial be?

Set a Shopify app free trial at least twice your median time to activation, rounded up to a whole week. If merchants activate in a median of 4 days, use 14 days, not 7. This is a rule of thumb, not a published benchmark.

A more careful version: size the trial to the 80th or 90th percentile of time to activation, because the median only counts merchants who do activate and makes a short trial look more generous than it is. Shopify lets you set trial length per plan, as a number of days, in the Partner Dashboard (shopify.dev, “Offer free trials”, checked 1 October 2026).

A free trial gives the merchant time to reach activation before paying, so a trial shorter than your time to activation asks merchants to pay before most of them have seen the app work.

Does a Shopify app free trial reset when a merchant reinstalls?

A Shopify app free trial does not reset when a merchant reinstalls. Shopify tracks trial use over a 180-day window, so uninstalling and reinstalling does not restart it. In Shopify’s own example, a merchant who uses 12 of 15 trial days, uninstalls, and reinstalls 90 days later has 3 trial days left (shopify.dev, “Offer free trials”, checked 1 October 2026).

That means a merchant who drifts away mid-trial comes back with less time. Helping them activate in the first session is worth more than a win-back later.

Where should you put help during onboarding?

Put help on the exact screens where setup breaks, so a stuck merchant can ask a question instead of giving up. A help link to a separate site is better than nothing; a chat inside your app, on the setup screen itself, is better still, because the merchant does not have to leave the step they are stuck on.

Convot’s widget can sit inside an embedded Shopify app: you add its short two-script snippet to the HTML shell that hosts your app in the Shopify Admin. Each app gets its own chat widget and help center, so a merchant on your setup screen can search an article or start a chat without leaving the page.

Should you reach out to merchants who have not activated?

Reach out to merchants who installed but have not activated within a day or two. A short message from a real person often unsticks a merchant who was one question away from giving up:

“Noticed you started setting up [app] yesterday but the [first booking page] is not live yet. Most people get stuck on [the step]. Want me to walk you through it, or set it up with you?”

The message above is illustrative; name the actual step from your own data. Convot’s Trigger Rules can also send a proactive message automatically when a condition matches, such as a merchant spending a set time on a given page, or a visitor who has never messaged you before, so the offer of help appears on the setup screen itself.

Why does the first support message matter?

The first support message from a new merchant matters because it arrives while they are deciding whether your app is worth their time. A fast, useful reply keeps the setup moving; a reply the next day may come after they have already uninstalled.

Set a faster response target for merchants in their first week than for established ones, and track first response time for that group separately. The guide to customer support metrics for Shopify apps covers how to measure it.

Which merchants deserve a setup call?

Offer a setup call to merchants whose stores make them worth extra effort, or who are stuck on something complex, and give everyone else a clear help article. A call costs you twenty minutes, so spend them where the outcome matters most.

For Shopify apps, once your server identifies the shop with a signed Convot.identify call, Convot shows that merchant’s plan and MRR beside the conversation, which helps you decide who gets a call. Revenue is visible to the account owner by default, and to admins only if you grant it. When a call makes sense, you can send a booking card inside the chat and the merchant picks a time without leaving the conversation. The guide to booking onboarding calls from support chat shows how.

How do you keep improving onboarding?

Keep improving onboarding by fixing one drop-off point at a time and measuring the effect on the next week’s installs:

1. Find the step where most non-activated merchants stopped.
2. Change one thing about that step.
3. Compare the activation rate of merchants who installed after the change with those who installed before.
4. Read the support conversations from merchants who got stuck, because they describe the problem in their own words.

Merchants who uninstall early are also telling you where onboarding fails. The guide to what to do when a merchant uninstalls covers how to read those signals, and the churn reduction playbook covers what happens after merchants start paying.

Common questions about Shopify app onboarding

Should you ask merchants to choose a plan before they use the app? Asking for a plan before the merchant has seen the app work adds a decision at the moment they know least. If you can, let them reach activation on a trial first.

What is a good activation rate? There is no reliable public benchmark for Shopify app activation rates, because activation means something different for every app. Track your own rate by install week and work on the trend.

Do onboarding emails help? Onboarding emails help when they point to the one next step a merchant has not taken. For example, send one email about 24 hours after install to merchants who have not activated, naming the single next step. Generic tips sent on a fixed schedule are easy to ignore.

The onboarding checklist

1. Define one activation moment you can detect in your data.
2. Track activation rate, time to activation and install-to-paid rate by install week.
3. Remove or shorten every step between install and activation.
4. Set the trial longer than the time it takes most merchants to activate.
5. Put help on the setup screens, inside your app.
6. Contact merchants who have not activated within a day or two.
7. Answer first-week merchants faster than everyone else.
8. Fix one drop-off point at a time, and measure the change.

Start free while you are under $1,000 in monthly revenue, and put help where onboarding breaks.

About the author

Tarang Agarwal is the founder of Convot. Convot is built by Sidepanda, a small studio that runs several Shopify apps of its own, including Appointo, Depo and Panda Bundle, and supports all of them from one Convot inbox.