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:

<script src="https://static.frisbii-media.com/web/v1/frisbii_media.min.js"
        data-company-id="{your_companyId}"
        data-lang="en"></script>

Stage (for development and testing):

<script src="https://static.frisbii-media-stage.com/web/v1/frisbii_media.min.js"
        data-company-id="{your_companyId}"
        data-lang="en"></script>

Replace {your_companyId} with your Company ID from the Frisbii Media backend under Settings → Developer.

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.

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

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>My Page</title>
</head>
<body>
    <!-- Your page content -->
    <!-- Container element for the checkout or SSO iframe -->
    <div id="plenigoCheckout"></div>
    <!-- SDK loads here, at the end of body -->
    <script src="https://static.frisbii-media-stage.com/web/v1/frisbii_media.min.js"
            data-company-id="{your_companyId}"
            data-lang="en"></script>
    <script>
        // Your plenigo.Checkout / plenigo.SSO / plenigo.Snippets calls go here
    </script>
</body>
</html>

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):

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)

⚠️ 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:

<!-- DEPRECATED – do not use for new implementations -->
<script src="https://static.plenigo.com/static_resources/javascript/{your_companyId}/plenigo_sdk.min.js"
        data-disable-redirect="true"
        data-companyId="{your_companyId}"
        data-lang="en"></script>

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