Selleasy works via app embed in Shopify, which means it loads along with your storefront as part of your theme. Every store is unique with different themes, different apps, different performance goals. To give merchants more control over how Selleasy fits into their store's loading sequence, we've introduced the Selleasy Script Initialization setting.
This setting lets you decide when Selleasy's script starts up on your storefront, so you can tune it to best suit your store's needs without changing anything about your campaigns or widgets.
What is script initialization?
When a visitor lands on your store, Selleasy's script needs to "start up" to display your upsell and cross-sell widgets. The Selleasy Script Initialization setting determines the exact moment this happens; right away with the page, after the page fully loads, or only when a visitor first interacts with your store.
Where to find this setting?
This is available in Shopify Theme Editor:
Shopify Admin→ Online Store→ Themes → Customize→ App Embeds→ Selleasy→ Selleasy Script Initialization
The three initialization options
Option 1: Default
Selleasy loads together with your theme's scripts, the same way it has always worked. Widgets are ready as soon as the page finishes rendering. This is the recommended starting point for most stores.
Highlights:
- Standard behaviour
- Selleasy widgets are readily available
Option 2: Initialize after document load
Selleasy waits until the browser has finished parsing and rendering your full HTML page before starting up. Your store's core content such as images, product details, navigation loads first, and Selleasy follows right after. This is ideal if you want to minimize any impact on your page's initial load.
Highlights:
- Reduced load impact
- Slight widget delay
Option 3: Initialize after user interaction
Selleasy stays dormant until a real visitor engages with your page such as a mouse click, a key press, a scroll, or a tap on mobile. Only then does it start up. This gives your page the maximum head start possible and is a great option for mobile-first stores.
Highlights:
- Minimal load impact
- Widgets appear on first interaction
Which option should you choose?
If your priority is | If your priority is | If your priority is |
Selleasy widgets should load along with the page and should be readily available | Improve page speed with minimal risk | Maximum page speed, especially on mobile |
→ Use Default | → Use Initialize after document load | → Use Initialize after user interaction |
Heads up with "Initialize after user interaction": Since Selleasy only loads once a visitor interacts with the page, upsell widgets will not be visible on the very first screen view. Visitors who immediately add to cart without any other interaction may miss the widget. We recommend testing this option in a draft theme before enabling it in the live theme.
FAQs
- Will changing this setting affect my existing campaigns? No. Your campaigns, offers, and discounts remain completely unchanged. This setting only controls the timing of when Selleasy's script starts, not what it shows.
- Can I switch between modes anytime? Yes, you can change this setting at any time from your Theme Editor. The change takes effect immediately for new visitors to your store.
- Will this affect my Google PageSpeed or Core Web Vitals score? The After document load and After user interaction modes delay Selleasy's JavaScript execution until after the main page content renders, which may positively influence speed scores. The exact impact depends on your theme and other installed apps.
- Does this setting apply to all pages on my store, or just the product page? This setting applies globally across your entire store. Whichever option you choose, Selleasy will follow the same initialization behaviour on every page where it is active — including product pages, the cart page, and any other pages where your upsell widgets are configured to appear.
- What happens if a visitor leaves before interacting with the page? If you are using the Initialize after user interaction option and a visitor lands on your store but leaves without clicking, scrolling, or tapping anything, Selleasy will never initialize for that session. This means those visitors will not see any upsell or cross-sell widgets during that visit. This is an expected trade-off of choosing the maximum speed option, and is worth keeping in mind if your store sees a high percentage of very short visits.
If you need any assistance regarding this, please feel free to contact our customer support team.