Onboarding

Onboarding is the process that merchants follow to set up your app. The onboarding process is crucial to merchant success.

Anchor to PurposePurpose

Onboarding should welcome merchants and make them eager to use your app or feature. Onboarding makes merchants comfortable and sets their expectations as soon as they start using your app.

Merchants should feel like they know what to do in your app after they've completed the onboarding experience. This leads to higher usage retention. Refer to the Polaris Setup guide pattern.

Anchor to GuidanceGuidance

Onboarding experiences efficiently guide merchants through your app's features so that merchants don't have to discover them on their own.

A great onboarding experience presents the basics of your app to merchants as quickly as possible.

Onboarding experiences can also come in the form of a selection of actions that are quick and easy for merchants to understand.

In some cases, complex onboarding can take longer than expected. Give merchants the option to complete the onboarding at a later time to avoid stopping their workflow.

While there isn't a ready-made Polaris pattern for setup guides, you can compose your own with Polaris components and look for examples across the Shopify admin. A good setup acts as a quick start, with discrete steps that are automatically marked as complete. Including a progress indicator is another good practice that provides encouraging feedback to merchants.

Request information from merchants only if it's necessary.

If your onboarding isn't essential, then make it dismissible using a Polaris Cancel icon.

Avoid more than five steps in your onboarding process, as additional steps can lead to merchant drop off.

Was this page helpful?