Make Rebuy load faster with the Rebuy Connector
The Rebuy Connector app embed is the recommended and fastest way to load Rebuy on your Shopify store. It loads Rebuy earlier in the page lifecycle and minimizes delays for Smart Cart, widgets, Smart Search, Bundle Builder, Smart Flows, and other Rebuy features. With the Rebuy Connector, a shopper's browser starts downloading Rebuy as soon as it begins reading the page, and connects to Rebuy's servers right away. Rebuy does not wait for images and other files to finish loading first. Your Rebuy features appear in the same places and work the same way, just sooner. No theme code changes are needed.
The Rebuy Connector is an app embed that you turn on in your Shopify theme. It loads Rebuy while the Enable Rebuy JS via Rebuy Connector setting is turned on in Rebuy. How much faster Rebuy gets depends on how your store loads Rebuy today.
If your store loads Rebuy through the older script tag setting, Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027), switching to the Rebuy Connector makes the biggest difference. Shopify runs script tags last, after everything else on the page has finished loading, including every image. Switching also keeps Rebuy working after March 1st, 2027, when Shopify stops running script tags.
If your store already loads Rebuy through the Rebuy Connector, it got faster automatically on September 29th, 2026, with nothing for you to change.
If your store loads Rebuy from code pasted into your theme, such as a
rebuy-scripts.liquidsnippet, the Rebuy Connector now does the same job with no theme code to maintain. It loads Rebuy just as early and connects to Rebuy's servers the same way.
How to load Rebuy through the Rebuy Connector (recommended)
To load Rebuy through the Rebuy Connector, you turn on the Rebuy Connector in your Shopify theme and turn on Enable Rebuy JS via Rebuy Connector in Rebuy. Changing one of these settings never changes another, so set each one yourself, in the order below.
In your Shopify admin, go to Sales channels > Online Store and click Customize on your published theme. The Rebuy Connector link in the Load Rebuy through the Rebuy Connector panel at the top of Rebuy's App Settings page also opens the theme editor.
In the theme editor, click the App embeds icon in the left sidebar, turn on Rebuy Connector, and click Save. If Rebuy Connector is already on, leave it on.
In the Rebuy admin, go to the Settings tab and select App Settings.
In the Load Rebuy through the Rebuy Connector panel at the top of the page, turn on Enable Rebuy JS via Rebuy Connector (formerly Install Rebuy Script Tag and Disable Rebuy JS). This setting tells the Rebuy Connector to load Rebuy, and it saves as soon as you turn it on, with no Save button.
If your General Settings section shows Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027), leave it as it is. It stops working on its own on March 1st, 2027.
Open your store and check that your Rebuy features, such as Smart Cart and your widgets, appear. If they do not, recheck the Rebuy Connector app embed on your published theme and Enable Rebuy JS via Rebuy Connector, and turn on whichever is off.
Keep Rebuy loading when you change themes
To keep Rebuy loading when you switch to a different Shopify theme, turn on the Rebuy Connector app embed in the new theme before you publish it. Shopify saves app embed settings separately for each theme, so the Rebuy Connector loads Rebuy only on themes where it is turned on.
In your Shopify admin, go to Sales channels > Online Store and click Customize on the theme you plan to publish.
Click the App embeds icon in the left sidebar, turn on Rebuy Connector, and click Save.
Publish the theme.
Enable Rebuy JS via Rebuy Connector applies to your whole store, so you do not need to change it when you switch themes. The Rebuy Connector works on Online Store 2.0 themes and vintage themes.
What each Rebuy loading setting does
The Rebuy Connector, Enable Rebuy JS via Rebuy Connector, and Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) settings each control a different part of how Rebuy loads on your store. The following table lists each setting, where to find it, how to set it, and what it does.
Setting | Where to find it | Set it to | What it does |
Rebuy Connector | Shopify theme editor > App embeds | On | Loads Rebuy as soon as the browser starts reading the page, while Enable Rebuy JS via Rebuy Connector is on. It also passes customer and market details, such as customer tags, country, and language, to Rebuy, even while it is not loading Rebuy. |
Enable Rebuy JS via Rebuy Connector (formerly Install Rebuy Script Tag and Disable Rebuy JS) | Rebuy admin > Settings > App Settings, in the Load Rebuy through the Rebuy Connector panel at the top | On | Tells the Rebuy Connector to load Rebuy. Turning it off stops the Rebuy Connector from loading Rebuy and permanently removes your store's Shopify script tag. |
Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) (formerly Enable Rebuy JS) | Rebuy admin > Settings > App Settings > General Settings | Leave as it is | The older way to load Rebuy, through a Shopify script tag. Shopify runs script tags only after the rest of the page finishes loading, and stops running them on March 1st, 2027. |
Keep Enable Rebuy JS via Rebuy Connector turned on unless your store loads Rebuy from its own theme code. Turning it off stops the Rebuy Connector from loading Rebuy, and it also removes your store's Shopify script tag. From October 1st, 2026, Shopify does not let Rebuy add that script tag back.
Leave the legacy script tag setting as it is
You do not need to change Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) when you move to the Rebuy Connector. Leave it on or off, however it is set today. The setting stops working on its own on March 1st, 2027, when Shopify stops running script tags, so there is nothing to turn off.
While the legacy setting is on and the Rebuy Connector is loading Rebuy, Rebuy is added to the page by the legacy script tag and by the Rebuy Connector. This is harmless. Rebuy runs the first copy and stops the second one right away, so your store keeps working.
If your store turned off the legacy setting after the Rebuy Connector was already loading Rebuy, your store keeps working and you do not need to turn it back on. From October 1st, 2026, turning it back on cannot restore a Shopify script tag.
What the Rebuy JS is already loaded message means
The Rebuy JS is already loaded. warning in your browser console means Rebuy's main script, rebuy.js, was added to the page more than once. Rebuy runs the first copy and stops any extra copy right away, so your store keeps working. When Rebuy loads through the Rebuy Connector, the extra copy usually comes from Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) still being on, or from a <script> tag in your theme code that loads rebuy.js.
When the extra copy comes from the legacy setting, the warning is expected and harmless until March 1st, 2027, so leave the setting as it is. When the extra copy comes from your theme code, search your theme code for rebuy.js and remove the <script> tag that loads it. Leave your other Rebuy code in place, such as custom widget templates, event listeners, and custom CSS, since that code does not load a second copy of Rebuy.
How Shopify's script tag changes affect how Rebuy loads
Shopify is retiring storefront script tags, the older way apps add code to a Shopify store. Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) loads Rebuy through a script tag. App embeds, such as the Rebuy Connector, are Shopify's replacement for script tags, so loading Rebuy through the Rebuy Connector keeps Rebuy working after these changes.
The following table lists each Shopify date, what Shopify changes on that date, and what the change means for your Rebuy store.
Date | What Shopify changes | What it means for your Rebuy store |
October 1st, 2026 | Apps can no longer create or update script tags. Existing script tags keep running. | Stores that already have Rebuy installed keep working on this date, and need to switch to the Rebuy Connector before March 1st, 2027. Stores that install Rebuy on or after this date need the Rebuy Connector app embed and Enable Rebuy JS via Rebuy Connector turned on for Rebuy to load on every page. |
March 1st, 2027 | Shopify stops running storefront script tags. | Stores that load Rebuy only through a Shopify script tag stop showing Rebuy features on their storefront, such as Smart Cart and widgets. Checkout Extensions and Post-Purchase offers keep working, since they do not use Rebuy's storefront script. Switch to the Rebuy Connector before this date. |
When to load Rebuy from your own theme code instead
Load Rebuy from your own theme code only for special cases, such as hiding Rebuy from certain customers or delaying Rebuy on purpose. For every other store, the Rebuy Connector is as fast as theme code and leaves nothing in your theme to maintain. For the theme code steps, see How to conditionally load Rebuy for certain users or on specific themes only.
Keep the Rebuy Connector app embed on even when your theme code loads Rebuy. The Rebuy Connector passes customer and market details to Rebuy, such as customer tags, country, and language. It keeps passing them even while Enable Rebuy JS via Rebuy Connector is off.
Turn off jQuery to speed up Rebuy
Turning off the Enable jQuery setting can make Rebuy load faster if your store does not rely on jQuery for custom code or templates. Stores that installed Rebuy on or after September 1st, 2025 have Enable jQuery turned off by default. For more detail, see jQuery and How It Affects Your Store.
In the Rebuy admin, go to the Settings tab and select App Settings.
In the General Settings section, turn off Enable jQuery.
Click Save.
Open your store and confirm that your Rebuy widgets and any custom Rebuy code still work. If something stops working, turn Enable jQuery back on and click Save.
Hide Rebuy widgets until they finish loading
Rebuy widgets can briefly show unfinished content, such as template placeholders, while they load. To hide Rebuy widgets until they are ready, add the CSS below inside the <head> of your theme's layout/theme.liquid file. You can also add just the [v-cloak] line to your theme's main stylesheet. CSS in the <head> takes effect before any Rebuy widget appears, and it works the same however Rebuy loads on your store.
<style>
/* Hide Rebuy widgets until they finish loading */
[v-cloak] { display: none !important; }
</style>
Adding this CSS is an optional theme code change. Test it on an unpublished copy of your theme first, and confirm your Rebuy widgets still appear once they finish loading. Before you publish that copy, make sure the Rebuy Connector is on in its App embeds, since Shopify saves app embed settings separately for each theme. Rebuy Support can explain this change but does not edit theme code, so you or your own developer make the edit.
FAQs
How can I make Rebuy load faster on my store?
To make Rebuy load faster on your store, load Rebuy through the Rebuy Connector app embed. The Rebuy Connector loads Rebuy earlier in the page lifecycle and minimizes delays for features like Smart Cart and widgets. Set it up in this order.
In your Shopify theme editor, open App embeds, turn on Rebuy Connector, and click Save.
In the Rebuy admin, go to Settings > App Settings and turn on Enable Rebuy JS via Rebuy Connector.
Leave Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) as it is.
If your store does not rely on jQuery, turning off jQuery can also help.
Why isn't Rebuy loading after I turned on the Rebuy Connector?
Rebuy usually does not load after you turn on the Rebuy Connector because Enable Rebuy JS via Rebuy Connector (formerly Install Rebuy Script Tag and Disable Rebuy JS) is still off. The Rebuy Connector loads Rebuy only while that setting is on, so turn it on in the Rebuy admin under Settings > App Settings. Also check that the Rebuy Connector is on in App embeds for your published theme, not only a draft theme, and that you clicked Save in the theme editor.
Why does Rebuy only appear on some pages of my new store?
On a store that installed Rebuy on or after October 1st, 2026, Rebuy appears only on pages with a Rebuy widget app block until the Rebuy Connector is set up. From that date, Shopify does not let Rebuy add its script tag to a new store. Until the Rebuy Connector loads Rebuy, Smart Cart and other features that run on every page do not appear. To fix it, turn on the Rebuy Connector in App embeds, then check that Enable Rebuy JS via Rebuy Connector is on in Settings > App Settings.
Should I remove the code that loads Rebuy from my theme?
Yes, once Rebuy loads through the Rebuy Connector, remove any <script> tag in your theme code that loads rebuy.js. That tag does not break your store, but it makes the browser download Rebuy twice. Remove only the code that loads Rebuy, and leave the rest of your Rebuy code in place, such as custom widget templates, event listeners, and custom CSS.
In your Shopify admin, open the code editor for your published theme and search your theme files for
rebuy.js.If the tag is in a snippet such as
rebuy-scripts.liquidthat also contains the[v-cloak]style, move that style into your theme's<head>or main stylesheet.Delete the
<script>tag. If it is in a snippet likerebuy-scripts.liquidthat only loads Rebuy, delete the whole snippet instead. First remove the line that renders it, such as{%- render 'rebuy-scripts' -%}inlayout/theme.liquid, then delete the snippet file.Save your changes, open your store, and check that your Rebuy features still appear.
Keep the tag only if your store uses it on purpose to control where Rebuy loads, as described in How to conditionally load Rebuy for certain users or on specific themes only. Rebuy Support can explain these steps but does not edit theme code, so you or your own developer make the changes.
Can I delay when Rebuy loads on my store?
Yes, you can delay Rebuy by loading it from your own theme code instead of through the Rebuy Connector. When the Rebuy Connector loads Rebuy, it places Rebuy's script in the <head> of every page, so theme code is the way to load Rebuy later on purpose. First, have your own developer add Rebuy's script where you want it in your theme, and confirm Rebuy loads from it. Then turn off Enable Rebuy JS via Rebuy Connector, so the Rebuy Connector stops loading its own copy of Rebuy. Turning it off also permanently removes your store's Shopify script tag, so confirm your theme code is loading Rebuy first. Leave the Rebuy Connector app embed on, since it still passes customer and market details, such as customer tags, country, and language, to Rebuy. Do not use Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) to delay Rebuy, since Shopify stops running script tags on March 1st, 2027. Rebuy Support can explain these steps but does not edit theme code, so you or your own developer make the changes.
Does loading Rebuy through the Rebuy Connector change my Smart Cart custom code?
No, loading Rebuy through the Rebuy Connector does not change your Smart Cart custom code. Custom code runs inside Rebuy after Rebuy loads, so it works the same way and simply runs sooner. Rebuy's checkout and post-purchase extensions load separately and are not affected.
When do I need to switch to the Rebuy Connector setup?
Stores that load Rebuy only through a Shopify script tag need to switch to the Rebuy Connector before March 1st, 2027, when Shopify stops running script tags. Until then, stores that already have Rebuy installed keep working, and switching sooner makes Rebuy load faster. Stores that install Rebuy on or after October 1st, 2026 need the Rebuy Connector right away, since Shopify no longer lets apps add script tags from that date. To switch, turn on the Rebuy Connector app embed and Enable Rebuy JS via Rebuy Connector using the steps in this article, and leave Enable Rebuy JS via script tag (legacy, ends Mar 1, 2027) as it is.