Overview & Video Walkthrough
Once you've installed Rivo and completed the setup wizard, there's one more important step to connect the app to your Shopify store. This involves toggling on the Rivo app embed for your theme, which unlocks all of Rivo's powerful on-site loyalty features. It's just a few clicks so read on!
Enabling Rivo's app embed: step by step
When you have finished installing Rivo, to enable our on-site displays, you'll need to toggle our app embed in your theme. Here's steps on how to do that:
From your Shopify admin, go to Online Store > Themes
On your live theme, click Customize
In the Theme editor, on the left sidebar menu, click App Embeds
Find the Rivo App embed and toggle it ON
Save your changes
Steps 1 & 2 - Go to Online Store > Themes and click Customize on your live theme
Steps 3,4 & 5 - Navigate to App embeds, toggle Rivo's embed ON and save your changes
What happens when you enable the app embed?
Enabling Rivo's app embed activates several powerful loyalty features on your storefront:
Floating Loyalty Widget
A customizable floating button appears on your storefront that customers can click to access their loyalty account. This widget provides:
Points Balance Display - Shows customers their current points and VIP tier status
Ways to Earn - Interactive list of all the actions customers can take to earn points
Rewards Catalog - Browse and redeem available rewards and discounts
Referral Program - Share referral links and track referral progress
Order History - View past orders and points earned from each purchase
Account Management Slideout
When customers click the floating widget, a sleek slideout panel opens with full account management capabilities:
Profile Management - Update personal information, birthday, and preferences
Points History - Detailed log of all points earned, spent, and expired
VIP Tier Progress - Visual progress toward the next VIP tier with benefits
Reward Redemption - One-click redemption of available rewards
Social Sharing - Easy sharing of referral links and social media actions
Seamless Theme Integration
The app embed integrates deeply with your Shopify theme to provide:
Automatic Customer Recognition - Instantly recognizes logged-in customers and displays their loyalty status
Real-time Updates - Points balances and rewards update immediately after purchases or actions
Mobile Optimization - Fully responsive design that works perfectly on all devices
Brand Customization - Automatically matches your store's colors, fonts, and styling
Multi-language Support - Displays in your customer's preferred language
Advanced Loyalty Features
The app embed also enables advanced functionality:
Deep Link Support - Direct customers to specific sections using special URLs (e.g., #ba-loyalty-rewards)
Landing Page Integration - Powers custom loyalty landing pages built with Shopify's theme editor
Checkout Integration - Displays loyalty information and redemption options during checkout
Email Integration - Enables loyalty data to sync with your email marketing campaigns
Analytics Tracking - Captures detailed engagement metrics for program optimization
Customization Options
Once the app embed is enabled, you can customize how it appears and behaves:
Widget Appearance
Control the visual design of your loyalty widget:
Colors & Branding - Match your brand colors, fonts, and styling
Button Position - Choose where the floating widget appears on your pages
Custom Logo - Add your logo to the widget header
Button Text - Customize the text that appears on buttons and calls-to-action
Visibility Settings
Control when and where the widget appears:
Device Targeting - Show or hide the widget on desktop vs mobile devices
Page Targeting - Display the widget only on specific pages or product categories
Customer Targeting - Show different content to VIP customers vs new visitors
Deep Link Mode - Hide the widget button but allow access via deep links
Content Customization
Tailor the loyalty experience to your brand:
Welcome Messages - Create custom greetings for new and returning customers
Reward Descriptions - Write compelling descriptions for your rewards and offers
Call-to-Action Text - Customize button text and promotional messages
Social Media Integration - Connect your social accounts for seamless sharing
Testing Your Setup
After enabling the app embed, here's how to verify everything is working correctly:
Immediate Checks
Visit Your Storefront - Go to your live website and look for the floating loyalty widget
Test Widget Functionality - Click the widget to ensure the slideout opens properly
Check Customer Experience - Log in as a test customer to see the personalized experience
Test on Mobile - Verify the widget works correctly on mobile devices
Advanced Testing
Test Deep Links - Try URLs like yourstore.com/#ba-loyalty-rewards to ensure direct navigation works
Verify Points Tracking - Make a test purchase to confirm points are awarded correctly
Test Reward Redemption - Try redeeming a reward to ensure the process works smoothly
Check Email Integration - Verify that loyalty data appears in your email campaigns
Troubleshooting
If you're experiencing issues with your app embed, try these solutions:
Widget Not Appearing
Clear Browser Cache - Hard refresh your browser (Ctrl+F5 or Cmd+Shift+R)
Check App Embed Status - Verify the toggle is still ON in your theme's App Embeds section
Sync Your Store - Go to Rivo's Troubleshooting Settings and click "Sync Store"
Test Different Pages - Try viewing the widget on different pages of your site
Widget Not Loading Properly
Check Internet Connection - Ensure you have a stable internet connection
Disable Browser Extensions - Ad blockers or privacy extensions may interfere with the widget
Test in Incognito Mode - This helps identify if browser extensions are causing issues
Contact Support - If issues persist, reach out to Rivo support with specific error details
Customer Data Not Syncing
Force Sync - Use the "Sync Store" button in Rivo's troubleshooting settings
Check Customer Login - Ensure customers are properly logged into their Shopify accounts
Verify Permissions - Confirm Rivo has the necessary permissions to access customer data
Wait for Processing - Large data syncs may take several minutes to complete
Common Questions
Why don't I see Rivo's on-site displays after toggling the switch on?
You may need to sync the app. Go to the Troubleshooting Settings page in Rivo (here's a direct link) and click Sync Store. Also, try clearing your browser cache and viewing your site in an incognito window.
Can I enable the embed on an unpublished theme to test the app?
Absolutely! Follow the steps above on an unpublished theme to test it out beforehand. This is a great way to preview how the loyalty features will look before making them live to customers.
Will the app embed slow down my website?
No, Rivo's app embed is designed for optimal performance. It loads asynchronously and only when needed, ensuring your website speed remains fast. The widget also includes smart caching to minimize load times.
Can I hide the floating widget but still use loyalty features?
Yes! You can hide the floating widget and use deep links to give customers access to their loyalty accounts. This is perfect if you want to integrate loyalty access into your navigation menu or custom buttons.
Does the app embed work with all Shopify themes?
Rivo's app embed is built using Shopify's official theme extension technology, ensuring compatibility with all modern Shopify themes. If you experience any theme-specific issues, our support team can help with customization.
Can I customize the appearance of the loyalty widget?
Yes! Rivo offers extensive customization options including colors, fonts, positioning, button text, and branding. You can access these settings in the Rivo dashboard under Onsite > Floating Widget.
What happens if I disable the app embed later?
If you disable the app embed, all on-site loyalty features will stop working, including the floating widget, account slideout, and landing pages. However, your loyalty program data and backend functionality will remain intact. You can re-enable the embed at any time to restore on-site features.