📋 Before You Start
The Mage Loyalty app embed must be enabled on your live Shopify theme before the sidebar will appear on your storefront. If you have not done this yet, see: How to Enable the Mage Loyalty App Embed.
What is the Account Sidebar?
The Account Sidebar is an area where customers can view their full loyalty & store account details. It includes order history, points or store credit history, rewards, profile information e.g. name and address, and more.
For You: personalised loyalty content: points balance, rewards, earning opportunities, and any configured blocks
Orders: recent order history and order status
Profile: customer account details
ℹ️ Note
Customers who are not logged in will see a sign-in prompt when the sidebar opens. The full loyalty experience: points balance, rewards, and personalised blocks. It is only visible to logged-in customers.
How to Enable the Account Sidebar
From your Shopify admin, open the Mage Loyalty app.
In the left menu, click Account Sidebar.
At the top of the page, find the Enable Account Sidebar toggle.
Toggle it on.
Click Save.
How to add the Account Sidebar Link
The account sidebar will open any time you append #mage to a link on your website.
Identify where you want to target the account sidebar, most people will target it via the 'profile' icon in their navbar
Edit the link in your stores navigation menu to append #mage to the end of the link. For example - https://your-store.com/#mage
Save the menu and test the button where you targeted #mage
The account sidebar should open
The sidebar is now live on your storefront. Customers who visit your store and click the chosen button will see the Mage account sidebar.
✅ Tip
Use the Preview panel on the right to check how the sidebar looks. Toggle between Logged Out and Logged In views to see both states.
What Can the Sidebar Display?
The sidebar is made up of configurable blocks. You choose which blocks are enabled, what they display, and the order they appear in. Here is a summary of every available block:
Block | What It Shows Customers | Logged In Only? |
Sign In Settings | Sign in prompt and account access for logged-out customers | No |
Loyalty Program Settings | Points balance, VIP tier, lifetime points, and available rewards | Yes |
Wishlist | Customer's saved wishlist items with add-to-cart functionality | Yes |
Advertisement | A promotional banner with an image, title, description, and optional link | No |
Custom Links | Merchant-configured navigation links, e.g. Contact Us, Subscriptions | No |
Call to Action | A prominent button with custom label text linking to any page | No |
Featured Products | A curated product grid pulled from a selected collection | No |
AI Product Reccomendations | Uses Shopify AI to recommend products to customers based on their browsing & order history | No |
Saved From Cart | A product grid showing items the customer removed from their cart. | Yes |
Recently Viewed | A product grid showing items the customer has recently viewed. | No |
Referral Code | A block displaying the customer’s personal referral code that they can share with others. | Yes |
✅ Tip
Optional blocks are added via the + Add button in the Blocks tab. You can add the same block more than once, for example, two Advertisement blocks for different promotions.
How Customers Access the Sidebar
There are two ways customers can open the Account Sidebar on your storefront:
Via the Rewards Widget: the floating launcher button on your storefront pages. Clicking it opens the sidebar from any page.
Via the account page URL: customers who visit your store's yourstore.com#mage URL will have the sidebar open automatically.
ℹ️ Note
The Rewards Widget and Account Sidebar work together. Make sure the Rewards Widget is also enabled so customers can open the sidebar from any page.
Navigating the Account Sidebar Page
The Account Sidebar configuration page inside Mage Loyalty has three tabs. Each controls a different aspect of the sidebar:
Blocks
Configure which blocks appear, what each shows, and their order. Add new blocks via + Add, delete unwanted blocks, and drag to reorder.
📖 See: Configure Sidebar Blocks
Design
Control colours, logo, and custom CSS.
Settings
Control position, width, z-index, floating style, animation, and custom font.
📖 See: Account Sidebar - Settings
Opening the Sidebar on a different page
Open the sidebar directly to a specific page by adding a hash to your store URL.
Hash | Opens |
| Sidebar (For You tab) |
| Loyalty Program overview |
| Ways to Earn points |
| Ways to Redeem rewards |
| Customer's claimed rewards |
| Customer's earning history |
| VIP Tiers |
| Gift Reminders |
| Wishlist |
Common Mistakes to Avoid
⚠️ Common Mistake
Enabling the sidebar before the app embed is active: the sidebar will not appear on your storefront until the Mage Loyalty app embed is enabled on your live theme. Always complete the app embed step first.
⚠️ Common Mistake
Not clicking Save after toggling the sidebar on: the toggle alone does not save the change. Always click Save before leaving the page.
⚠️ Common Mistake
Expecting the sidebar to show content without any blocks enabled: if all blocks are toggled off, the sidebar will open but display nothing. Enable at least the Loyalty Program block to give customers something to interact with.
Troubleshooting
The sidebar is enabled but not appearing on my storefront
Confirm the Mage Loyalty app embed is enabled on your current live theme. This is the most common cause. See: How to Enable the Mage Loyalty App Embed.
Check that you clicked Save after enabling the toggle.
Open your storefront in an incognito browser window to rule out caching.
Customers cannot find the sidebar
Make sure the Rewards Widget is enabled: this is the floating launcher button that gives customers access to the sidebar from any page.
You can also link customers directly to the sidebar by pointing them to yourstore.com#mage - for example, in an email or navigation link.
Related Articles
🗨️ Still need help or can’t find the answers you’re looking for? Reach out to the Mage Loyalty team through our live chat support.