Installation

Install, load and initialize Supertab.js on a Website

Prerequisites

You’ll need your Website’s clientId to initialize Supertab.js. If you haven’t created a Website yet, follow the guide Create Websites first.

To find your Website’s clientId, log in to the Business Portal, navigate to Organization / Websites, then click the ”…” button next to your Website.

Quick Start

Choose an installation method based on your setup:

• Using a bundler (Webpack, Vite, Rollup, etc.) → Install from npm
• Modern browsers with ES modules → CDN with ES Module import
• Legacy browser support → CDN with global loader

From npm

Install Supertab.js from npm for use with bundlers like Webpack, Vite, or Rollup:

npm install @getsupertab/supertab-js

Import, load and initialize the client in your application:

async/await

import { loadSupertab } from "@getsupertab/supertab-js";

(async () => {
    const { Supertab } = await loadSupertab();
    const supertabClient = new Supertab({ clientId: "test_client.X" });
})();

loadSupertab() loads the latest compatible Supertab.js version from our CDN. It must be called in a browser environment—it won’t work server-side.

Directly from CDN

Load Supertab.js directly from our CDN without a build step. Two options:

With an ES Module import

Use this method for modern browsers that support ES modules:

<script type="module">
    import { Supertab } from "https://js.supertab.co/v3/supertab.js";

    const supertabClient = new Supertab({ clientId: "test_client.X" });
</script>

With the global loader

Use this method for environments without ES module support. The script supertab.global.js exposes the global function window.loadSupertab():

async/await

<script src="https://js.supertab.co/v3/supertab.global.js"></script>
<script>
    (async () => {
        const { Supertab } = await window.loadSupertab();
        const supertabClient = new Supertab({ clientId: "test_client.X" });
    })();
</script>

Versioning

CDN URLs are versioned. Using v3 automatically loads the latest 3.x.x version (patch and minor releases). Breaking changes are released as new major versions.

Next Steps

Once installed, you can launch experiences or build custom purchase flows:

• Starting experiences
• SDK Overview