How to embed your Saleium sale on your own website (Embed Studio)

Updated Jun 21, 2026, 09:47 AM

Embed Studio turns any deployed Saleium instance into a widget you can paste on your own website, with a domain allowlist, an SRI-pinned snippet, the matching CSP directives, and a shareable hosted page URL.

Who this is for: Operators who have already deployed a Saleium instance and want to surface it on their own site or share a hosted link.

What is Embed Studio?

Embed Studio is the live dashboard tool that generates the code to embed a deployed Saleium instance on your website. You pick the product and instance, style it, set a security allowlist, and it produces an HTML snippet plus the security headers to add. It also gives you a public hosted page you can simply share if you do not want to embed.

It supports four products: Token Sale, Staking, Vesting, and Airdrop. The Airdrop widget embed is still rolling out. You can register and pin it now so you are ready when it lands.

How do I create an embed?

Open Embed Studio and choose the Product (Token Sale, Staking, Vesting, or Airdrop).
Choose the Chain your instance is on.
Enter the deployed instance ADDRESS you want to embed.
Set an Accent color so the widget matches your brand.
Toggle "Show Powered by Saleium" on or off (this is the watermark).
Set Allowed domains as a comma-separated list. Wildcards like *.myproject.com are supported.
Set your RPC URLs.
Check the live preview on the right to confirm it looks correct.
Click "Generate embed snippet."

You receive three things: an integrity-pinned (SRI) HTML snippet to paste on your site, the CSP directives to add to your site's headers, and a public hosted page URL you can share. The widget version is shown next to the snippet. Pin it (see below).

How does the allowlist keep my widget secure?

The embed only runs on the domains you list under Allowed domains. The allowlist is enforced: any domain that is not on your list is blocked from loading the widget. This is your control to stop other sites from embedding your sale. Use wildcards like *.myproject.com to cover subdomains without listing each one.

What do I do with the SRI snippet and CSP directives?

The snippet is integrity-pinned using Subresource Integrity (SRI), so the browser verifies the widget code has not been tampered with before it runs. Paste the snippet where you want the widget to appear on your page. Then add the CSP directives Embed Studio gives you to your site's Content Security Policy headers, otherwise the browser may block the widget from loading or connecting. Both pieces are generated together. Add both.

How do I pin the widget version?

Embed Studio shows the widget version alongside the snippet. Pinning it means your embedded widget stays on that exact version instead of silently moving as the platform updates. Keep the version that the generated snippet references so your page behaves consistently. When you are ready to move up, regenerate the snippet and update your page.

Can I just share a link instead of embedding?

Yes. Embed Studio gives you a public hosted page URL with every snippet, so you can share that link directly. For a token sale, the hosted public page also lives at https://saleium.io/sale/{chainId}/{saleAddress}, where {chainId} is your chain and {saleAddress} is the deployed sale contract address you received after deploy.

What about the accent color and watermark?

The Accent color restyles the widget to match your site. The "Show Powered by Saleium" toggle controls the Saleium watermark. Turn it on to credit Saleium, or off for a cleaner look on your own page. Both update in the live preview before you generate the snippet.

Common issues

Widget does not load on my site: confirm the page's domain is on your Allowed domains list. Non-allowlisted domains are blocked by design. Add the domain (or a *.subdomain wildcard) and regenerate if needed.
Browser console blocks the widget: you likely have not added the CSP directives Embed Studio generated. Add them to your Content Security Policy headers.
Widget looks unstyled or wrong: re-check the Accent color and the live preview before generating, and confirm your RPC URLs are set.
Airdrop embed not generating a full snippet yet: the Airdrop widget embed is still rolling out. You can register and pin it now.