Manage the storefront widget
What does this do for me?
The storefront widget displays loyalty content — points balances, referrals, rewards, the loyalty hub, popups, memberships, and more — directly on your Shopify theme. It consists of 10 Liquid blocks that merchants add to their theme. The widget setup steps below apply to all plans. Custom branding and popup creation require the Growth plan or higher.1. Open storefront setup
- In the app sidebar, select Home.
- Under Quick Actions, find Setup Wizard and select Start Setup.
- Continue to Add storefront widgets.
- Choose a Theme, then choose a Widget or app embed.
- Select the add or activate action for your choice to open the Shopify theme editor.
read_themes scope to list your store’s themes so you can select which theme receives the loyalty blocks.
2. Add widget blocks to your theme
The theme extension provides these blocks:- Points Display — shows the customer’s current point balance.
- Referral Widget — displays the customer’s referral link and code.
- Cart Rewards — shows available rewards during checkout.
- Loyalty Hub — the full-page loyalty hub with points, tiers, rewards, and referrals.
- Popup — on-site loyalty modals with trigger options.
- Memberships — paid membership enrollment and status.
- Households — family wallet grouping.
- B2B — company account loyalty information.
- Social Rewards — social media follow/share reward prompts.
- Birthday Collection — birthday date input widget.
3. Customize widget appearance
- In the app sidebar, select Settings.
- In the Branding card, select Configure branding.
- Customize the colors, logo, typography, or CSS to match your brand.
- Select Save Theme.
4. Create a popup
- In the app sidebar, select Referrals, then select Popups in the section navigation.
- Select Create Popup.
- Complete the popup details and select Create Popup.