New Loyalty page
Design your loyalty page inside Joy — a live preview beside every setting, and cards that read your real programs, tiers and balances.
You can open the editor and save drafts on all plans. Publishing the New Loyalty page to your storefront requires Essential or above, so on Free the page goes live once you upgrade.
Stores that install Joy start on the New Loyalty page. If your store is still on the Classic Loyalty page, you switch it yourself — see Switch between the Classic and New Loyalty page. Your Classic setup stays saved either way. Looking for the block-based guide? See Classic Loyalty page.
What is different in the New Loyalty page
The Classic Loyalty page spread the page across three places: blocks in the Shopify theme editor, a separate page the app injected, and settings with no preview. The New Loyalty page replaces all three with one editor in Joy.
The page also stops repeating itself. On the Classic Loyalty page, program names, rewards and tier perks were text you typed into the page, so renaming a program in Joy left the page quietly saying the old thing. On the New Loyalty page, those cards read your live programs, tiers, balances and coupon inventory when the page loads.
Open the editor
In Joy, go to On-site content and open the Loyalty page tab.
Find the New loyalty page card and click Open editor.

The editor opens full screen, with the preview on the right and four tabs on top.

| Tab | What it holds |
|---|---|
| Design | Starting preset and Theme & layout, Go live under Setup to put the page on your storefront, and Custom CSS under Advanced |
| Sections | Which sections are on the page, in which order, and the settings for each one |
| On-brand | Brand scan — read your storefront and match the page to it. Banner images — make the hero and Refer a friend images from your products |
| Translations | Every word on the page, per language |
Above the preview, open the Preview as menu to switch between Desktop and Mobile, and between Member, Guest, and — on stores using opt-in enrolment — Signed in · not joined. Check the guest view before you finish: it is what a shopper who has never joined sees.


Saving is publishing
The editor uses the Shopify save bar at the top of the screen. On Essential and above, Save writes your draft and pushes it to the storefront in one step, so there is no separate publish button to remember. If the save fails, nothing reaches the storefront. On Free, Save stores your draft only.
Closing the editor with unsaved changes discards them. Joy asks first.
A Publish changes button appears in one case only: when your saved design is ahead of what shoppers see, which happens if an AI assistant such as Claude or ChatGPT saved changes through an AI connection without publishing them.
Start from a template
Design → Starting preset gives you eight starting points: Fashion, Beauty & Wellness, Food & Drink, Home & Garden, Sports & Fitness, Pets & Animals, Men's Grooming, and Minimal. Each one brings its own hero and referral imagery.

Applying a preset replaces your section order and visibility, your theme, layout, media and card styling, and the headings, descriptions and button labels in your primary language. It keeps your Custom CSS and every live program, tier and referral connection. Joy shows you that list before it applies anything.
Sections
The Sections tab holds two lists: Page sections, in the order shoppers see them, and More sections, the rest of the catalogue. Drag a section between the lists or use + to add one.

Each section on the page has a drag handle to reorder it, a toggle to hide it while keeping it, and × to take it off the page entirely. Removing a section does not delete what you wrote — add it back and your text returns.
The last section on the page cannot be removed. A page with no sections reads as "never set up", and the storefront falls back to a default page. Hide the section instead.
The catalogue has fifteen sections:
| Section | What it shows |
|---|---|
| Hero banner | Image or video, with separate headlines for signed-in shoppers and guests |
| Sign-up banner | An invitation to join, with its own copy for signed-in and guest states |
| How it works | Your program explained in steps |
| Ways to earn | Cards for your active earning programs — content from live data |
| Ways to redeem | Cards for your redeeming programs — same live data |
| VIP tiers | Tier comparison and the benefit matrix |
| Refer a friend | Referral offer, both sides of it, with companion imagery |
| FAQs | Questions and answers, reorderable, each one hideable |
| Rewards redemption | The rewards this shopper can redeem right now |
| My rewards | The coupons and rewards already in their account |
| Rewards activity | Their points history |
| Loyalty dashboard | Points summary, tier badge, coupons, points history |
| Referral management | Their referral link and referral activity |
| Loyalty pass wallet | Apple Wallet and Google Wallet buttons |
| Link accounts | Account linking |
Every section carries three settings of its own: Full width, Show this block to (Everyone, Members only, or Non-members only), and an Appearance group with a card theme that follows the page until you override it for that section.
Section panels hold layout, colors and media — not words. Every heading, button label and paragraph on the page is written in the Translations tab, even if your store has one language. Each panel carries an Edit text shortcut that takes you there.
Ways to earn and Ways to redeem share their program settings
Program order, program visibility and program icons are set once per program and apply to both sections. Reordering or hiding a program saves with the rest of the page when you click Save; icon changes save in the icon window itself.
Only programs that are active and flagged to show on the loyalty page appear at all.
In the Ways to earn panel, Move completed programs to the end shows programs a member has already earned after the ones they can still do. Turn it off to keep the order you set.
VIP tiers
The tier columns and the benefit values are live — they come from your VIP Tier program, not from text on the page. The panel controls how that matrix is presented: table layout, the marks for included and excluded benefits, and card styling.
Desktop layouts are Table, Colored columns, Cards, and Card slider. Phones use their own layout, and a tier table becomes cards there, because tables do not fit a phone screen.
An exclusive tier is assigned by hand, so its card shows no points target. It shows the description you wrote for the tier in Membership, in the shopper's language when a translation exists. With no description of your own, the card says "Exclusive tier".
The tier badge you pick is stored on the tier itself, so the same badge shows in VIP tiers, the Loyalty dashboard and the loyalty widget. Create a VIP tier before choosing one. Tier names sit in an 82×82 px badge — short names like "Gold" fit comfortably, long ones wrap.
In Loyalty dashboard, Show VIP tier badge is off by default. Turn it on if you want the badge there; the VIP tiers section shows tiers regardless.
Where the words live
Translations holds the page's copy for every language your store has, grouped by section. It reads and writes the same values as Settings → Translations → Loyalty page, so a change in one place is a change in both.

Text is live as soon as you save. Unlike the design, copy does not wait behind a draft — the storefront reads it directly.
- Editing language picks which language you are writing. Languages themselves are added and removed in Settings → Translations, not here.
- Search loyalty-page translations finds a string by its text.
- Ask AI to edit text takes a plain-language request, such as "make the Earn button say Get rewards". Joy lists the labels it would change, and only the ones you select with Apply selected change.
- On-brand rewrites the copy of the language you are in, in your store's voice.
- Revert to default restores Joy's built-in wording for the current language and keeps the text you wrote for your own steps and benefits. It cannot be undone.
Your own steps and tier benefits are keyed by their id, so renaming or reordering them does not scramble their translations.
Filling a second language only fills strings that are still empty. If you rewrite an English string that was already translated, the other language keeps its old wording until you update it there too.
Images and video
Images upload to Shopify Files, and the media browser lets you reuse any image or video already in your store. Video accepts MP4, MOV and WEBM up to 30 MB, or a direct HTTPS MP4 link. Shopify takes a few minutes to process a new video.
Custom CSS
Advanced → Custom CSS takes standard CSS, including media queries and keyframes, scoped to this page. The limit is 32 KiB, counted for you as you type.
Editing Custom CSS requires a paid plan. On the free plan, CSS you already saved keeps working and can be removed, but not edited.
On-brand brand scan
On-brand → Brand scan (Beta) reads your storefront and proposes a page that matches it. Enter your storefront URL — plus the storefront password, if your store has one; Joy uses it once and does not store it.
Pick what to scan: Colors and typography, Imagery, and Voice and copy, then click Scan storefront. The design half and the copy half run independently, so one failing does not cost you the other. A scan takes around 40 seconds.

Results arrive as a review: your current value next to the proposed one, line by line. Nothing changes until you choose Apply selected changes or Apply all changes. Fonts are only proposed where you have not already chosen one.
The scan writes page-level theme values. Overrides you set on individual sections stay as they are.
Make hero and referral images with Joy AI
On-brand → Banner images draws pictures for the page from your own products. Joy makes two images for each of three spots: Hero image (desktop), Hero image (mobile) and Refer a friend. You pick the one you like.
Creating images is available on Advanced. On lower plans the panel shows your current images and View plans.
Find your product photos
Open On-brand → Banner images and select Find product photos. Joy picks the clearest photo of each product and works out the look of your images. This can take up to a minute. The photos it will use show under Photos Joy will use, and you can add up to 8 of your own with Add a photo.
Create the images
Spots with no image yet are ticked for you. Tick the spots you want and select Create. You can leave the page while Joy works, and the images are there when you come back.
Pick one image per spot
Each spot shows Image 1 and Image 2. Select one to see the photos and prompt behind it, then select Use this image. The image marked In use is the one on your page, and Use Image 2 instead switches to the other. Undo brings back what the spot showed before, and Remove clears the spot.
Save the page
Joy never changes your page on its own. The image goes into your draft when you select Use this image, and it is saved with the rest of the page when you click Save.
Not happy with an image? Select Regenerate for a new version of the one you are looking at, and the other image stays. To steer the result, select Edit prompt and change the wording or the reference photos.
You can also start from the image fields. In Sections, Make this image with Joy AI under the hero and Refer a friend images opens Banner images at that spot.
Joy saves the images it makes to your Shopify Files.
Put the page on your storefront
Setup → Go live tracks the two steps that make the page reachable. Both must be done.

Create the loyalty page
Click Create page and choose the address shoppers will use, under /pages/. Shopify decides the final handle.
Show it on your page
Click Edit in theme editor, create a template for your loyalty page, and add the Joy: New Loyalty Page block to it.
Give the loyalty page a template of its own. Adding the block to your shared page template puts the loyalty program on every page.
Joy cannot add the block for you — Shopify does not let apps write to a theme — so the second step happens in the theme editor. Once both steps are done, View the live page opens the real thing.
The block has one setting, Content: All sections for the whole page, or a single section if you would rather place sections yourself with several blocks. If you use both, the all-in-one block wins and the others stay quiet.
Until the page and the block both exist, the editor shows a banner saying the page is not live yet. Your design is still saved.
Switch between the Classic and New Loyalty page
Stores that start on the New Loyalty page see only its editor. Stores that started on the Classic Loyalty page — including stores that uninstalled and came back, whose themes still hold Classic blocks — stay on the Classic Loyalty page until they switch.
Click Switch to new loyalty page in Setup → Go live or on the Loyalty page tab. The New Loyalty page goes live immediately; if you have not published a design yet, shoppers see the default page until you do. Your Classic setup stays saved, and you can switch back with Switch to classic loyalty page.
Limits worth knowing
| Limit | What happens |
|---|---|
| Page data, 64 KB | Publishing stops with a message rather than writing a partial page. Fewer sections, shorter copy, or fewer visible programs bring it back under. |
| Custom CSS, 32 KiB | The editor counts bytes and blocks a save above the limit |
| Video, 30 MB | Upload larger files to Shopify Files directly, then pick them from store videos |
| Last section | Cannot be removed from the page; hide it instead |
Frequently asked questions
Do I have to move to the New Loyalty page?
No. The Classic Loyalty page keeps working, and switching is reversible in both directions.
Can I use the New Loyalty page on the Free plan?
You can open the editor, preview the page and save a draft on Free. Publishing it to your storefront requires Essential or above.
What happens to my Classic Loyalty page blocks?
They stay in your theme with their settings. While the store is on the New Loyalty page, those block instances render the New Loyalty page instead, and switching back restores the old rendering.
Which block do I add in the theme editor?
Add Joy: New Loyalty Page to a template of its own. Set its Content to All sections for the whole page.
Can shoppers see the page while I work on it?
They see your last published version. There is no separate staging copy — use the Mobile, Desktop and customer-state switches above the preview to check each state before you save.
Why do some earn programs show at the end of Ways to earn?
Move completed programs to the end is on in the Ways to earn panel. Programs a member has already earned show after the ones they can still do. Turn it off to keep your own order.
Why does my exclusive tier show no points target?
Customers do not reach an exclusive tier with points, so the card does not show a target. It shows the tier description instead, or "Exclusive tier" when the tier has none. To change it, open the tier in Membership, edit its description and click Save.
Why can I not find the wording for a heading in its section panel?
It is in Translations, along with every other word on the page. Use Edit text in the panel to jump straight to it.
Why can't I create images with Joy AI?
Creating images is available on Advanced. On a lower plan, Banner images shows your current images and View plans. You can still select Remove or Undo on an image Joy already made for your page.
Will Joy replace an image I uploaded?
No. A spot with your own image is not ticked for you. If you create one anyway, Joy shows Current next to New, and you choose Keep current or Use new.
What if the hero text is hard to read on an image?
Joy warns you under the image: white text may be hard to read. Select Hero settings to make the overlay darker, or use the other image.
Where do the images come from?
Joy reads your products, picks the clearest photo of each one and draws the images from those photos in your store's style. Add up to 8 photos of your own with Add a photo to steer it.
How do I refresh the photos after my products change?
Select Find photos again. Joy reuses what it found for products that did not change. To read everything again, open the ⋯ menu and choose Find photos again from scratch.
What if Joy cannot make an image?
Joy's image service can decline a prompt or a photo. Change the wording or swap a photo, then select Create again.
Why does Joy ask me to wait?
Joy makes images for one screen at a time. If it is already working on your widget banners, wait until they are done, then select Create again.
Need help?
Reach out at [email protected] with your store URL and "New Loyalty page" in the subject — we will check your page setup with you.