Skip to main content
The plugin takes a merchant through five steps and always shows the one they’re on. You don’t choose the screen: Branduo works it out from the store’s state each time the plugin loads.

​
Listen for stage changes

Pass onEvent to BrandConnect.init to hear about the merchant’s stage. It fires when the plugin loads and whenever the stage changes:
stage is one of install, plan, setting_up, delayed, consent, or live. This is the only event. It never includes personal information. You don’t need it for the plugin to work.

​
Install

The store doesn’t have the Branduo Shopify app yet. The plugin explains how cross-promotion works and links to Install Branduo on Shopify.
The install stage: a checklist with Install Branduo current, a short explanation, and an Install Branduo on Shopify button

​
Plan

The app is installed, but the merchant hasn’t approved their Branduo plan in Shopify. Approve plan opens Shopify’s plan page. There are no monthly fees: Branduo takes a small share of the first order from each new customer a partner refers.
The plan stage: Install Branduo checked and an Approve your Branduo plan screen
To bring merchants back to your app after they approve, see Bring merchants back.

​
Setting up

Branduo is importing the store, building the merchant’s offer from their best sellers, and finding brands that fit. This usually takes a minute or two. The plugin checks progress on its own and moves on when setup finishes.
The setting up stage: a progress list with Importing your store, Creating your offer, and Finding brands that fit your store
If setup runs longer than usual, the stage becomes delayed and the plugin tells the merchant it’s still working. Branduo keeps retrying in the background.
The delayed stage: This is taking longer than usual
Setup is done. The merchant sees a preview of their offer as shoppers at partner brands will see it: their logo, a tagline, up to three best sellers, and the discount. They choose the discount for new customers (10%, 15%, 20%, or 25%), then select Turn on cross-promotions. Doing so accepts the Terms and Privacy Policy.
The consent stage: an offer preview card, discount choices from 10% to 25%, where offers show, and a Turn on cross-promotions button
When they turn it on, Branduo creates one discount code in their Shopify store, usable once per customer, and starts showing their offer. If the store already has its Branduo discount, the plugin shows that percentage instead of the choices.

​
Live

Cross-promotion is on. The merchant sees their live offer and a link to manage partnerships and campaigns in Branduo.
The live stage: You're in, with the merchant's live offer card
A merchant who turned on cross-promotions through another app is already live when they open yours. They never consent twice.

​
Messages instead of a stage

Sometimes the plugin shows a message instead of a stage. In these cases, onEvent isn’t called. See Troubleshooting for setup problems on your side.