Skip to main content

v1 to v2 Migration Guide

You're currently running our Online Sizing v1 widget? Great! We're glad to welcome a long time customer.

This guide shows you how to uninstall v1 and install v2. Let's get started!

Step 1: Remove onlineSizer config

Somewhere in your page you defined the onlineSizer config object which looks something like this:

api: {
username: "test",
password: "xxx"
bikeName: "E-Scale 720",
widgetUrl: "",
code: "7613368093183",
bikeImageUrl: ""

You can remove that – but maybe copy paste it somewhere to pick parts from it in future steps.


If you defined callback functions to i.e. select the frame size after the widget closes, you can keep those in place and continue to use them.

Step 2: Remove scripts

If you added jQuery to your shop back then just for Online Sizing, you can go ahead and safely remove that:

<!-- Remove this if it's only used by Online Sizing -->
<script src=""></script>

Then there's the actual onlinesizer.js script which can be safely removed as well:

<script src="https://[YOUR-ID]"></script>

Step 3: Remove HTML elements

Now you can go ahead and delete the last missing pieces of HTML from your product page related to OZ v1:

<!-- This is the element which will be populated with the onlineSizer HTML markup -->
<div class="smartfit-onlinesizing" id="onlinesizer-target"></div>

<!-- This is the button to show the onlineSizer after successful initialization -->
<button id="trigger-onlineSizer">Find your size</button>

You can keep the button if you like – we can use that for the new version of Online Sizing.

Step 4: Install the new widget

Now that you've uninstalled v1 you can follow our new Integration guide to setup v2 🎉.