• GETTING STARTED • SETUP GUIDE

How to Enable the Rivio App Embed in Your Shopify Theme

By Rivio Support Team
4 min read

How to Enable the Rivio App Embed in Your Shopify Theme

Before Rivio COD & Partial Payments can display the customer verification popup, offer upfront deposits, or calculate Cash on Delivery fees on your storefront, its Theme App Embed must be turned on inside your Shopify theme editor.

Unlike older Shopify apps that inject custom Liquid scripts directly into your theme code, Rivio uses Shopify’s native App Embed architecture. This means zero code edits, zero slowdowns to your Google PageSpeed scores, and clean 1-click activation.

In this guide, you will learn how to turn on the Rivio app embed in under two minutes.

Before You Begin

Before enabling the embed, confirm that:

  • You have installed Rivio COD & Partial Payments on your Shopify store.
  • You have staff permissions to edit your store's online theme (Online Store → Themes).

Step-by-Step Instructions

  1. From your Shopify admin, navigate to Apps → Rivio COD & Partial Payments.
  2. On the Home dashboard, locate the setup banner at the top labeled Enable Rivio on your storefront.
  3. Click the Enable app embed button.
📸 SCREENSHOT PLACEHOLDER: SC-COD-001

Rivio COD dashboard highlighting the Enable app embed setup banner button

Rivio COD dashboard highlighting the Enable app embed setup banner button

Clicking this button automatically opens your live Shopify theme editor in a new browser tab with the Rivio COD & OTP toggle already switched on!

  1. If you prefer to open the theme editor manually:
  • In your Shopify admin, go to Online Store → Themes.
  • Next to your published theme, click Customize.
  • In the far-left vertical sidebar, click the App embeds icon (the third icon from the top).
  1. Locate the Rivio COD & OTP embed (cod_otp) in the list and ensure the toggle switch is turned ON (green).
📸 SCREENSHOT PLACEHOLDER: SC-COD-002

Shopify theme editor left sidebar showing the Rivio COD app embed toggle switch enabled

Shopify theme editor left sidebar showing the Rivio COD app embed toggle switch enabled
  1. In the upper-right corner of the theme editor, click Save.
  2. Return to your Rivio app dashboard. In the Setup guide checklist on the Home page, verify that the first task—Turn on the theme app embed—now displays a completed checkmark.

Configuration Settings & Options

Setting Location Description Best Practice Recommendation
Rivio COD & OTP Toggle Theme Editor → App embeds Activates the lightweight storefront popup script across your store. Keep ON on your live published theme at all times.
Theme Editor Save Top-right corner Commits the embed activation to your live theme files. Always click Save after toggling; otherwise changes will not apply.

Example Scenario

Launching COD for a New Clothing Brand

A merchant launches a boutique apparel store on the Shopify Horizon theme. After configuring their COD rules in the Rivio dashboard, they notice the verification popup does not show up on the cart page. By clicking Enable app embed and pressing Save in the theme editor, the popup instantly becomes active for all shoppers, allowing them to verify their phone numbers before ordering.

Important Notes & Limitations

When you duplicate your theme, publish a new theme, or test an unreleased theme draft, you must enable and save the app embed on that specific theme before the popup will appear.

Simply toggling the switch inside the theme editor is not enough—you must click the Save button in the top-right corner to publish the change to your storefront.

Troubleshooting

The app embed is turned on, but the popup still does not display

  • Possible Cause: The embed was saved on a draft theme rather than your live published theme, or your browser is showing cached storefront pages.
  • How to Fix:
  1. Go to Online Store → Themes and confirm which theme is marked as Current theme.
  2. Click Customize on the current theme and confirm that the embed is toggled ON.
  3. Open your storefront in an Incognito / Private browsing window to bypass local browser cache.

You see an error saying "Theme editor could not be reached"

  • Possible Cause: Third-party ad blockers or strict browser tracking protection can block the theme editor deep-link.
  • How to Fix:
  1. Temporarily disable browser ad-blockers for admin.shopify.com.
  2. Navigate directly to Online Store → Themes → Customize → App embeds in your Shopify admin.

Related Guides

Need Help?

Need assistance enabling the app embed on your theme? We're here to help!