Loyalest — Storefront & theme setup

This guide explains how to add Loyalest to your Online Store using the theme app extension (app embed and app blocks). You can follow the steps manually or use the deep links below to open the theme editor with the correct app pieces ready to enable or add.

Before you start

Install Loyalest from the Shopify App Store and complete in-app onboarding.
Use a Online Store 2.0 theme (JSON templates) so app blocks and app embeds are available. Vintage themes may not support all features.
Replace your-store.myshopify.com in the examples below with your shop's .myshopify.com admin domain (not your custom storefront domain).

App embed: Loyalest | Bubble

The floating Loyalest | Bubble appears on storefront pages and powers the loyalty widget experience for signed-in customers. It is an app embed (not a section block).

Theme editor path: Online Store → Themes → Customize → App embeds (left sidebar) → find Loyalest | Bubble → toggle it On → Save.

Technical handle (for deep links): star_rating — this matches the extension file name (star_rating.liquid).

App blocks

These blocks are added inside a section on a template (e.g. product, page, cart). In the theme editor, open the template you need, click Add block, then under Apps choose Loyalest.

Name in editor	Handle (deep link)	Typical use
Loyalest \| Product Badges	`product_badges`	Product templates — tier or loyalty badges on the product page.
Loyalest \| Earn Points	`earn_points`	Product (or compatible) templates — show points earned for the current product.
Loyalest \| Cart Rewards	`cart_rewards`	Cart template — rewards summary or cart-related messaging.
Loyalest \| Rewards page	`rewards_page`	A dedicated Page template — full rewards catalog / redemption UI.
Loyalest \| Review form	`review_form`	Product or page templates — collect product reviews tied to your program.
Loyalest \| Wishlist page	`wishlist_page`	A Page template — customer lists / saved products when you use that feature.

After adding a block, use the block settings in the sidebar to connect products, URLs, or copy where the block exposes them.

Manual setup (step by step)

In Shopify admin, go to Online Store → Themes.
On your live (or draft) theme, click Customize to open the theme editor.
Enable the Bubble (app embed): open App embeds from the left sidebar. Find Loyalest | Bubble, turn it on, adjust settings if needed, then save.
Add app blocks: use the top drop-down to select a template (for example Products → Default product, or Pages for a rewards or list page). Click Add section or add into an existing section, then Add block → Apps and choose the Loyalest block you need. Position the block, configure settings, and save.
For a dedicated URL (for example /pages/rewards), create a page in Online Store → Pages and assign a template that includes the Loyalest page block, or add the block to the page template your theme uses.

Deep links (preview in theme editor)

Deep links take merchants straight into the theme editor so they can preview the app embed or insert an app block before saving. Parameters follow Shopify’s theme app extension deep linking documentation.

Use your app client ID fd24d59a9f555eb9c2b90ea2e1e06a5d in the URLs below (this is public and matches the Loyalest App Store app).

Activate the app embed (Bubble)

Opens the app embeds panel and targets the Bubble embed:

https://your-store.myshopify.com/admin/themes/current/editor?context=apps&template=index&activateAppId=fd24d59a9f555eb9c2b90ea2e1e06a5d/star_rating

Add an app block to a template

Replace product with another JSON template name if needed (cart, page, collection, etc.). Replace earn_points with any block handle from the table above.

https://your-store.myshopify.com/admin/themes/current/editor?template=product&addAppBlockId=fd24d59a9f555eb9c2b90ea2e1e06a5d/earn_points&target=newAppsSection

Examples for other blocks: use addAppBlockId=fd24d59a9f555eb9c2b90ea2e1e06a5d/cart_rewards on the cart template, or …/rewards_page on a page template, and so on.

Checkout & customer accounts (not theme blocks)

Loyalest also ships checkout and customer account UI extensions. These are not added under Themes → Customize; they are managed from Shopify’s checkout and customer account editors.

Checkout: In admin, go to Settings → Checkout (or the checkout editor for your store), then add and configure Loyalest | Checkout where checkout blocks are allowed.
Customer accounts: Use the customer account / profile customization experience in admin to enable Loyalest | My Loyalty (profile) and Loyalest | Loyalty Dashboard (full page) as described in Shopify’s customer account extension docs.

Support

If something does not appear in the theme editor, confirm the app is installed, your theme supports app blocks, and you are editing the correct theme. For help, use the contact details in the Loyalest App Store listing.