Skip to main content

Using Rebuy preview mode

Test Smart Cart, widgets, and datasources before going live — without affecting your live store.

Written by Diana Ibarra
Updated this week

What is Rebuy Preview Mode?

Rebuy Preview Mode lets you view and test products that are not yet live. When a Rebuy product is in preview mode, it is invisible to customers and can only be seen by someone viewing the store in preview mode.

This is useful any time you want to test changes internally before releasing them to shoppers.

There are two main methods to avoid testing on a live store:

  1. Install Rebuy on a duplicate theme and test there first. See Load Rebuy on Specific Themes for setup instructions.

  2. Use Rebuy Preview Mode — covered in this article.

Note: Preview Mode works for Smart Cart and Widgets. It is not available for Checkout Extensions (use the Shopify Checkout Editor preview) or Post-Purchase offers.


How to Enable Widget Preview Mode

Widget preview mode lets you view unpublished Rebuy widgets on your storefront without showing them to customers.

Enable Widget Preview Mode via the Rebuy Dashboard

From Rebuy Admin > Dashboard, click ONLINE STORE. This opens your store's live theme in a new tab and automatically places you in Rebuy's Widget Preview Mode (if Rebuy is installed on that theme).

Note: If Rebuy is not installed on your live theme, clicking ONLINE STORE opens your store without activating preview mode.

Enable Widget Preview Mode via the Widget Editor

When a widget is created, it is automatically in live mode. To place a widget in preview mode, open that widget's editor settings and toggle off Live Mode. Then click the "PREVIEW" link at the top right.

Note: The widget must be installed in your Shopify theme to appear in preview mode. Attempting to view a widget in preview mode without it being installed on the theme will not display it.

Enable Widget Preview Mode manually via URL

Add ?preview=true to the end of your store URL in the browser.

?preview=true

Example: If your store URL is https://your-store.myshopify.com/, the preview URL looks like:

https://your-store.myshopify.com/?preview=true

Confirmation: When Widget Preview Mode is active, the Rebuy preview bar appears at the bottom of your browser displaying Widgets.


How to Enable Smart Cart Preview Mode

Smart Cart preview mode lets you test an inactive Smart Cart on your live theme before making it live to customers

Use the PREVIEW button from the Smart Cart editor (recommended)

  1. Go to Rebuy Admin > Smart Cart.

  2. Scroll down to find the Smart Cart you want to preview.

  3. Click the PREVIEW button. This opens your store's live theme in a new tab with Smart Cart Preview Mode active.

Confirmation: When Smart Cart Preview Mode is active, the Rebuy preview bar appears at the bottom of your browser displaying Smart Cart. Your URL will also show the preview parameters.

Note: If Rebuy is not installed on your live Shopify theme, preview the correct theme first, then click the PREVIEW button.

Enable Smart Cart Preview Mode manually via URL

Append the following to your store URL, replacing XXXX with your Smart Cart ID (found in the URL bar when viewing that cart's settings in Rebuy Admin):

For Smart Cart V2:

?preview_smart_cart=XXXX&cart_version=2

Example:

https://your-store.myshopify.com/?preview_smart_cart=5848&cart_version=2

Important: The correct value for the latest cart_version parameter is 2 (the number).


How to Preview Smart Cart and Widgets at the Same Time

Smart Cart Preview Mode and Widget Preview Mode are separate by default. You can combine Smart Cart and widget preview mode to test both simultaneously on your storefront.

Append the following to your store URL, replacing XXXX with your Smart Cart ID:

?preview_smart_cart=XXXX&cart_version=2&preview=true

Example:

https://your-store.myshopify.com/?preview_smart_cart=5848&cart_version=2&preview=true

Confirmation: When both modes are active, the Rebuy preview bar at the bottom of your browser displays Widgets & Smart Cart.


Using the Toggle Highlight feature of Rebuy Preview mode

Toggle Highlight places a colored border around every Rebuy product on the page. This makes it easy to identify which elements are powered by Rebuy versus your theme or other apps.

To use Toggle Highlight:

  1. Enable Widget Preview Mode by appending ?preview=true to your store URL.

  2. In the Rebuy preview bar at the bottom of your browser, click Toggle Highlight.

To customize the highlight color and border thickness, go to Rebuy Admin > Settings > Themes and scroll to Rebuy Element Highlight.


Datasource Previewer

The Datasource Previewer is a testing tool that lets you simulate different customer scenarios and see what products your datasource rules would return — before anything goes live.

Where to find it: Rebuy Admin → Data Sources → [select your datasource] → Preview Ruleset (within the datasource settings)

What you can simulate:

  • Different cart subtotals

  • Item counts in the cart

  • Customer tags

  • Specific input products

  • Your Datasource Rules based on items added to the cart

This lets you verify your rules are working as expected and fine-tune recommendations without affecting real customers.

For a full walkthrough, check out the Help Center guide: Previewing Data Sources


Troubleshooting Smart Cart Preview Mode

The live Smart Cart appears instead of the preview cart

Cause: The cart_version parameter is missing or set to an invalid value.

Fix: Make sure your URL includes &cart_version=2 (the number 2, not v2). A valid V2 preview URL looks like:

?preview_smart_cart=XXXX&cart_version=2

Replace XXXX with your Smart Cart ID from the URL bar in your cart's settings.

Preview mode doesn't load on the first try

Caching can occasionally prevent a preview link from loading immediately. If preview mode doesn't activate on the first try, click the link a second time.

Preview mode doesn't work on a draft or password-protected theme

You must be logged in to your Shopify store before using a preview link on a draft or password-protected theme. Log in first, then append the preview parameters to your URL.

Widget preview doesn't show anything

The widget must be installed on your theme to appear in preview mode. Attempting to view a widget in preview mode without it being installed on the theme will not display it.


Preview Mode FAQs

Does Preview Mode work on Checkout Widgets?

Preview Mode does not work for Widgets on Checkout Extensions. Use the Shopify Checkout Editor preview tool for those widgets instead.

Does Smart Cart Preview Mode work for Post-Purchase offers?

Smart Cart Preview Mode does not currently work for Post-Purchase offers. Preview tools for Post-Purchase are coming in a future update.

Can I preview Smart Cart on a draft theme?

Yes. Make sure Rebuy is installed on the draft theme and that you are logged in to your Shopify store before using the preview link.

What Smart Cart ID do I use in the preview URL?

Your Smart Cart ID appears in the URL bar when you are viewing that cart's settings in Rebuy Admin. For example, if the URL shows /smartcart/edit/5848, your ID is 5848.

Does Smart Cart preview mode work with Smart Cart Legacy (V1)?

Smart Cart Legacy preview mode works the same way as V2, but uses a different URL parameter set. To preview a Legacy cart manually, append the following to your store URL:

?preview_smart_cart=XXXX

To preview a Legacy Smart Cart and Widgets at the same time:

?preview_smart_cart=XXXX&preview=true

Replace XXXX with your Smart Cart ID. Note that cart_version=2 is not required for Legacy carts and should be omitted.

I'm on Smart Cart Legacy — does the PREVIEW button still work?

Yes. The PREVIEW button in the Smart Cart editor works for both Smart Cart V2 and Legacy. The correct URL parameters are applied automatically when you use the PREVIEW button in the Smart Cart editor, so you don't need to construct the URL manually.

Did this answer your question?