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
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:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Supertab docs","colors":{"primary":"#0A0E1A","light":"#F3F3F4","dark":"#0A0E1A"},"logo":{"light":"https://mintcdn.com/supertab/bP-daIW8qZO4pzbo/logo/light.svg?fit=max\u0026auto=format\u0026n=bP-daIW8qZO4pzbo\u0026q=85\u0026s=47631a4a02f7428d1c2479d804aea54d","dark":"https://mintcdn.com/supertab/bP-daIW8qZO4pzbo/logo/dark.svg?fit=max\u0026auto=format\u0026n=bP-daIW8qZO4pzbo\u0026q=85\u0026s=0fae8412d2464504a082bd910292aa43"},"favicon":"https://mintcdn.com/supertab/nIjMo5xiY0_gRI-4/favicon.webp?fit=max\u0026auto=format\u0026n=nIjMo5xiY0_gRI-4\u0026q=85\u0026s=419af455c4dcfc9b93f2893e0ccec259","api":{"playground":{"display":"simple"}},"navbar":{"links":[{"href":"https://support.supertab.co/hc/en-us/requests/new","label":"Support"}],"primary":{"type":"button","label":"Business Portal","href":"https://business.supertab.co"}},"footer":{"socials":{"x":"https://x.com/getsupertab","linkedin":"https://www.linkedin.com/company/supertab"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"supertab","hasAudioNarration":false,"actualSubdomain":"supertab","customDomains":["docs.supertab.co"],"gitSource":{"type":"github","owner":"laterpay","repo":"supertab-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae9227464072a14c6718829:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Supertab.js","count":14},{"language":"default","tag":"Customer API","count":12},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Endpoints","count":9},{"language":"default","tag":"Merchant API","count":6},{"language":"default","tag":"Introduction","count":5},{"language":"default","tag":"Supertab Experiences","count":5},{"language":"default","tag":"Reference","count":4},{"language":"default","tag":"Integrate","count":3}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@supertab.co"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"supertab-js/installation","slug":"/supertab-js/installation","pageMetadata":{"title":"Installation","description":"Install, load and initialize Supertab.js on a Website","href":"/supertab-js/installation"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install, load and initialize Supertab.js on a Website\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.p,{children:[`You’ll need your Website’s `,_jsx(_components.code,{children:`clientId`}),` to initialize Supertab.js. If you haven’t created a Website yet, follow the guide `,_jsx(_components.a,{href:`/supertab-experiences/sites`,children:`Create Websites`}),` first.`]}),`\n`,_jsxs(_components.p,{children:[`To find your Website’s `,_jsx(_components.code,{children:`clientId`}),`, log in to the `,_jsx(_components.a,{href:`https://business.supertab.co/`,children:`Business Portal`}),`, navigate to Organization / Websites, then click the ”…” button next to your Website.`]}),`\n`,_jsx(Heading,{level:`2`,id:`quick-start`,children:`Quick Start`}),`\n`,_jsx(_components.p,{children:`Choose an installation method based on your setup:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Using a bundler`}),` (Webpack, Vite, Rollup, etc.) → `,_jsx(_components.a,{href:`#from-npm`,children:`Install from npm`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Modern browsers with ES modules`}),` → `,_jsx(_components.a,{href:`#with-an-es-module-import`,children:`CDN with ES Module import`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Legacy browser support`}),` → `,_jsx(_components.a,{href:`#with-the-global-loader`,children:`CDN with global loader`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`from-npm`,children:`From npm`}),`\n`,_jsx(_components.p,{children:`Install Supertab.js from npm for use with bundlers like Webpack, Vite, or Rollup:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` install @getsupertab/supertab-js`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Import, load and initialize the client in your application:`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`async/await`,numberOfLines:`6`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { loadSupertab } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@getsupertab/supertab-js\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`async`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` () => {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { Supertab } = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` loadSupertab();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` supertabClient = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`new`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Supertab({ clientId: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"test_client.X\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`})();`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`.then()`,numberOfLines:`5`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { loadSupertab } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@getsupertab/supertab-js\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`loadSupertab().then(({ Supertab }) => {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` supertabClient = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`new`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Supertab({ clientId: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"test_client.X\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`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.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`directly-from-cdn`,children:`Directly from CDN`}),`\n`,_jsx(_components.p,{children:`Load Supertab.js directly from our CDN without a build step. Two options:`}),`\n`,_jsx(Heading,{level:`3`,id:`with-an-es-module-import`,children:`With an ES Module import`}),`\n`,_jsx(_components.p,{children:`Use this method for modern browsers that support ES modules:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`html`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`html`,children:_jsxs(_components.code,{language:`html`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` type`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"module\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Supertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://js.supertab.co/v3/supertab.js\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` supertabClient`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Supertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`clientId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"test_client.X\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`with-the-global-loader`,children:`With the global loader`}),`\n`,_jsxs(_components.p,{children:[`Use this method for environments without ES module support. The script `,_jsx(_components.code,{children:`supertab.global.js`}),` exposes the global function `,_jsx(_components.code,{children:`window.loadSupertab()`}),`:`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`async/await`,numberOfLines:`7`,language:`html`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`html`,children:_jsxs(_components.code,{language:`html`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` src`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://js.supertab.co/v3/supertab.global.js\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` () `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`Supertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` window`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`loadSupertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` supertabClient`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Supertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`clientId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"test_client.X\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })();`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`.then()`,numberOfLines:`6`,language:`html`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`html`,children:_jsxs(_components.code,{language:`html`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` src`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://js.supertab.co/v3/supertab.global.js\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` window`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`loadSupertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`().`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`then`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(({ `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`Supertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` supertabClient`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Supertab`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`clientId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"test_client.X\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`versioning`,children:`Versioning`}),`\n`,_jsxs(_components.p,{children:[`CDN URLs are versioned. Using `,_jsx(_components.code,{children:`v3`}),` automatically loads the latest `,_jsx(_components.code,{children:`3.x.x`}),` version (patch and minor releases). Breaking changes are released as new major versions.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsx(_components.p,{children:`Once installed, you can launch experiences or build custom purchase flows:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/supertab-js/experiences/starting-experiences`,children:`Starting experiences`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/supertab-js/reference/overview`,children:`SDK Overview`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Installation","description":"Install, load and initialize Supertab.js on a Website","href":"/supertab-js/installation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Quick Start","slug":"quick-start","depth":2,"children":[]},{"title":"From npm","slug":"from-npm","depth":2,"children":[]},{"title":"Directly from CDN","slug":"directly-from-cdn","depth":2,"children":[{"title":"With an ES Module import","slug":"with-an-es-module-import","depth":3,"children":[]},{"title":"With the global loader","slug":"with-the-global-loader","depth":3,"children":[]}]},{"title":"Versioning","slug":"versioning","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"supertab","siteName":"Supertab docs","title":"Installation - Supertab docs","navMaps":{"firstHrefInVersion":{"v3":{"href":"/supertab-js/installation","matchLevel":0},"2025-04-01":{"href":"/customer-api/overview","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-01-22T10:51:53.709Z","originalFileLocation":"supertab-js/installation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install, load and initialize Supertab.js on a Website\">\u003cmeta data-mint-head name=\"application-name\" content=\"Supertab docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Installation - Supertab docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install, load and initialize Supertab.js on a Website\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Supertab docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.supertab.co/supertab-js/installation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://supertab.mintlify.site/_mintlify/api/og/v2?division=Supertab.js\u0026amp;title=Installation\u0026amp;description=Install%2C+load+and+initialize+Supertab.js+on+a+Website\u0026amp;theme=a787be16a1efd3a0409f7aca\u0026amp;signature=9c7af88b40ae7c59bb67bc1764cb7143f5bb89bac4acc096c0c0a210f97af672\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Installation - Supertab docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install, load and initialize Supertab.js on a Website\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://supertab.mintlify.site/_mintlify/api/og/v2?division=Supertab.js\u0026amp;title=Installation\u0026amp;description=Install%2C+load+and+initialize+Supertab.js+on+a+Website\u0026amp;theme=a787be16a1efd3a0409f7aca\u0026amp;signature=9c7af88b40ae7c59bb67bc1764cb7143f5bb89bac4acc096c0c0a210f97af672\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/supertab/24UJgC29HVwRWzPH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Supertab docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0E1A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.supertab.co/supertab-js/installation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/supertab-js/installation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.supertab.co/#organization\",\"name\":\"Supertab docs\",\"url\":\"https://docs.supertab.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/supertab/bP-daIW8qZO4pzbo/logo/light.svg?fit=max\u0026auto=format\u0026n=bP-daIW8qZO4pzbo\u0026q=85\u0026s=47631a4a02f7428d1c2479d804aea54d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.supertab.co#website\",\"name\":\"Supertab docs\",\"url\":\"https://docs.supertab.co\",\"publisher\":{\"@id\":\"https://docs.supertab.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.supertab.co/supertab-js/installation#webpage\",\"url\":\"https://docs.supertab.co/supertab-js/installation\",\"name\":\"Installation\",\"description\":\"Install, load and initialize Supertab.js on a Website\",\"dateModified\":\"2026-01-22T10:51:53.709Z\",\"isPartOf\":{\"@id\":\"https://docs.supertab.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.supertab.co/supertab-js/installation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.supertab.co/supertab-js/installation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Supertab.js\",\"item\":\"https://docs.supertab.co/supertab-js/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Installation\",\"item\":\"https://docs.supertab.co/supertab-js/installation\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.supertab.co/supertab-js/installation#article\",\"headline\":\"Installation\",\"name\":\"Installation\",\"description\":\"Install, load and initialize Supertab.js on a Website\",\"url\":\"https://docs.supertab.co/supertab-js/installation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.supertab.co/supertab-js/installation#webpage\"},\"dateModified\":\"2026-01-22T10:51:53.709Z\",\"publisher\":{\"@id\":\"https://docs.supertab.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.supertab.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Supertab docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Supertab docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/supertab-js/installation.md","siteName":"Supertab docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/supertab-introduction/overview/about-supertab"}]},{"tab":"Updates","pages":[{"title":"Updates","href":"/updates/product"}]},{"tab":"Supertab.js","versions":[{"version":"v3","groups":[{"group":"Supertab.js","pages":[{"title":"Getting Started","description":"Build with Supertab in the browser","href":"/supertab-js/introduction"},{"title":"Installation","href":"/supertab-js/installation"}]},{"group":"Experiences","pages":[{"title":"Paywall Experiences","description":"Launch a Paywall and handle user choices","href":"/supertab-js/experiences/paywall"}]},{"group":"API Reference","pages":[{"title":"SDK Overview","sidebarTitle":"Overview","href":"/supertab-js/reference/overview"},{"title":"Supertab.createPaygate","tag":"DEPRECATED","href":"/supertab-js/reference/create-paygate"},{"title":"Supertab.createPaywall","href":"/supertab-js/reference/create-paywall"},{"title":"Supertab.createPurchaseButton","href":"/supertab-js/reference/purchase-button"},{"title":"Supertab.createPurchase","sidebarTitle":"Supertab.createPurchase","href":"/supertab-js/reference/create-purchase"},{"title":"Supertab.auth","href":"/supertab-js/reference/auth"},{"title":"Supertab.api","href":"/supertab-js/reference/api"},{"title":"Supertab.checkout","href":"/supertab-js/reference/checkout"},{"title":"Errors","href":"/supertab-js/reference/errors"}]}]}]},{"tab":"API Reference","dropdowns":[{"dropdown":"Customer API","icon":"browsers","versions":[{"version":"2025-04-01","groups":[{"group":"Introduction","pages":[{"title":"Customer API","sidebarTitle":"Customer API","icon":"browsers","href":"/customer-api/overview"}]},{"group":"Reference","pages":[{"title":"Authentication","sidebarTitle":"Authentication","icon":"lock","href":"/customer-api/authentication"},{"title":"Versioning","sidebarTitle":"Versioning \u0026 Changes","icon":"calendar-clock","href":"/customer-api/versioning"}]},{"group":"Guides","pages":[{"title":"Making a Purchase","icon":"circle-dollar-to-slot","href":"/customer-api/making-a-purchase"},{"title":"Check for Entitlements, including Prior Entitlements","sidebarTitle":"Check for Entitlements","icon":"check","href":"/customer-api/entitlements"}]},{"group":"Endpoints","pages":[{"title":"Retrieve current customer","openapi":"GET /customers/me","href":"/customer-api/endpoints/retrieve-customer"},{"title":"Retrieve website","openapi":"get /site","href":"/customer-api/endpoints/retrieve-site"},{"openapi":"post /purchases/offerings","title":"Purchase an offering","href":"/customer-api/endpoints/purchase-an-offering"},{"openapi":"get /onetime_offerings/{onetime_offering_id}","title":"Retrieve a one-time offering","href":"/customer-api/endpoints/retrieve-a-one-time-offering"},{"openapi":"post /purchases/onetime_offerings","title":"Purchase a one-time offering","href":"/customer-api/endpoints/purchase-a-one-time-offering"},{"openapi":"get /purchases/{purchase_id}","title":"Retrieve a purchase","href":"/customer-api/endpoints/retrieve-a-purchase"},{"openapi":"get /entitlements/{content_key}","title":"Retrieve entitlement status","href":"/customer-api/endpoints/retrieve-entitlement-status"}]}]}]},{"dropdown":"Merchant API","icon":"server","versions":[{"version":"2025-04-01","groups":[{"group":"Introduction","pages":[{"title":"Merchant API","sidebarTitle":"Merchant API","icon":"server","href":"/merchant-api/overview"}]},{"group":"Reference","pages":[{"title":"Authentication","sidebarTitle":"Authentication","icon":"lock","href":"/merchant-api/authentication"},{"title":"Versioning","sidebarTitle":"Versioning \u0026 Changes","icon":"calendar-clock","href":"/merchant-api/versioning"}]},{"group":"Endpoints","pages":[{"title":"Create New One-Time Offering","openapi":"post /onetime_offerings","href":"/merchant-api/endpoints/create-onetime-offering"},{"title":"Retrieve a One-Time Offering","openapi":"get /onetime_offerings/{onetime_offering_id}","href":"/merchant-api/endpoints/retrieve-onetime-offering"}]},{"group":"Webhooks","pages":[{"title":"Consuming Webhooks","sidebarTitle":"Consuming Webhooks","icon":"globe","href":"/merchant-api/webhooks/consuming-webhooks"}]}]}]}]}]},"basePath":"","title":"Installation - Supertab docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}