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.
The Account Sidebar is an add-on to Mage Loyalty, starting at $499 per month.
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 | Points balance, VIP tier, lifetime points, and available rewards | Yes |
Wishlist | Customer's saved wishlist items with add-to-cart functionality | Yes, unless guest wishlists are allowed |
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 |
Product Recommendations | A product grid of your best sellers, or of Shopify's product recommendations | No |
Saved from Cart | A product grid showing items the customer removed from their cart. | No |
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 |
Tier Progress | The customer's current VIP tier, the next tier, and progress towards it. | Yes |
Redeem Rewards | Lets customers redeem a reward in exchange for points directly inside the sidebar. | Yes |
Latest Order | The customer's most recent order at a glance | Yes |
Save for Later | The products the customer has saved for later | Yes |
Kimonix Element | A Kimonix element, such as personalised product recommendations. Needs the Kimonix integration. | No |
Tip
Optional blocks are added with the Add button under Pages, then Home. 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:
From a link ending in #mage: any link on your store that ends in #mage opens the sidebar, for example the account icon in your menu. See "How to add the Account Sidebar Link" above.
From your theme's own account links: turn on Replace account links on the Settings tab and your theme's account and sign-in links open the sidebar, with no menu changes. See Account Sidebar - Settings.
Note
The Rewards Widget launcher opens the Rewards Widget, not the Account Sidebar. They are separate features, so enabling the Rewards Widget does not give customers a way into the sidebar.
Navigating the Account Sidebar Page
The Account Sidebar configuration page inside Mage Loyalty has three tabs. Each controls a different aspect of the sidebar:
Pages
Edit each screen of the sidebar. Home holds the blocks customers see first: add new blocks with Add, delete unwanted blocks, and drag to reorder. Orders and Profile control the order and profile screens.
Design
Control the logo, colours, width, z-index, floating style, animations and custom CSS.
Settings
Control account links, sidebar position, custom font and which products can appear in the sidebar.
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 |
| Saved for Later |
| Saved from Cart |
| My Preferences |
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 a link on your store ends in #mage, for example your account icon, or turn on Replace account links on the Settings tab.
You can also link customers directly to the sidebar by pointing them to yourstore.com#mage - for example, in an email or navigation link.
I cannot see Account Sidebar in the Mage menu
The Account Sidebar is an add-on. Contact the Mage team through live chat to add it to your store.
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.