---
title: "Installation & Setup"
slug: "installation-setup"
updated: 2026-06-10T09:11:37Z
published: 2026-06-23T10:52:16Z
canonical: "help.frisbii.com/installation-setup"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://help.frisbii.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Installation & Setup
The Frisbii Media JavaScript SDK provides the tools to embed checkout, SSO, and the self-service portal into any website. It loads as a single script tag and requires no package manager or build step.
---
## Script tag
Place the script tag at the **end of your** `<body>` element, just before `</body>`. JavaScript embeds can slow down page load — placing the script at the end ensures the rest of your page renders first.
**Live:**
```plaintext
```
**Stage (for development and testing):**
```plaintext
```
Replace `{your_companyId}` with your Company ID from the Frisbii Media backend under **Settings → Developer**.
> [!NOTE]
> Your stage account uses a **different Company ID** than your production account. Make sure you use the correct one for each environment. See [Environments: Stage vs. Live](/frisbii-media/docs/environments).
---
## Script tag attributes
| Attribute | Required | Description |
| --- | --- | --- |
| `data-company-id` | ✅ | Your Frisbii Media Company ID |
| `data-lang` | | Language code for the SDK UI, e.g. `en`, `de`, `fr`. Defaults to `en`. |
---
## Minimal HTML structure
```xml
My Page
```
---
## URL length limit
If you use dynamic URLs for the page that contains the checkout, make sure the **full URL does not exceed 220 characters** — including protocol, port, path, and all query parameters.
**Example of a URL that is too long (253 characters):**
```plaintext
https://www.example.com/news/architecture/park-and-garden/why-everybody-needs-to-have-oaks-behind-the-house.0a2937db-e3f1-471f-8a5d-80212929ee30.html?utm_source=homepage&utm_medium=web&utm_campaign=summer_sale&utm_term=architecture&utm_content=gardening
```
This limit applies equally to the `returnUrl` config option.
---
## Upgrading from the legacy SDK (before May 2025)
> [!CAUTION]
> ⚠️ **Deprecated:** The legacy plenigo v3 SDK URL is no longer current. If you are still using the script tag below, you must migrate to the new URL.
**Old (deprecated) script tag:**
```plaintext
```
**Changes required when upgrading:**
- Replace the entire SDK URL with the new `static.frisbii-media.com` URL
- The Company ID is **no longer part of the URL path** — it is now passed only via `data-company-id`
- The attribute name changed from `data-companyId` to `data-company-id` (note the lowercase `id`)
- Remove `data-disable-redirect="true"` — this attribute no longer exists
---