> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanfare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Run it on your own site

> Embed the Fanfare entry widget on your own website, share credentials with your developer, and know what changes when you don't publish a hosted page.

Run drops right on your own product or campaign pages by embedding the Fanfare widget—either alongside a Fanfare-hosted page (Growth and above) or completely on its own. It's the same interactive widget used on hosted pages and supports every drop type: queues, draws, auctions, timed releases, and appointments.

By default, visitors on your site see a **Get started** button before entering unless your developer configures the widget to launch automatically. If you'd like a standalone hosted page too, see [Build and publish the hosted page](https://docs.fanfare.io/guide/create/hosted-page.md).

## Before you start

* Your experience is created in Fanfare.
* You have a developer who can add the widget to your website.

## Share credentials with your developer

**1. Open API Keys**

In the Fanfare admin, go to **Settings → API Keys**. Any team member can view these credentials.

**2. Copy your Organization ID and Publishable key**

Under **Your credentials**, copy your **Organization ID** and **Publishable key** and share both with your developer.

**3. Share the Quick start snippet and SDK docs**

Point your developer to the **Quick start** card on the same page (pre-filled with your organization's credentials) and select **Read the SDK docs** for full setup details—also available in the [SDK docs](https://docs.fanfare.io/sdk/components/react.md).

**4. Send the experience ID**

Open the experience you want to embed and copy its ID from the browser URL (the segment right after `/app/experiences/`). Your developer will replace the placeholder experience ID in the **Quick start** snippet with this value.

![The API Keys page, with the Quick start card above and the Your credentials card below, listing the Organization ID and the Publishable key, each with a copy button. The Publishable key row is ringed.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/guide-create-your-own-site-credentials.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=93e476d3f0935b55141556ed3579ff61)

Share your Organization ID, Publishable key, and the experience ID with your developer.

> [!WARNING]
>
> For a draw, timed release, or auction sequence set to **Customer Picks**, your website must run **Fanfare SDK 0.20.0 or later** so shoppers can pick their product on entry. Older SDK versions can't display the picker and will block entry on your site (hosted pages aren't affected). Check your SDK version with your developer before launching—see [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md).

> [!WARNING]
>
> Never put your secret key in frontend or website code—it's strictly for your backend server. See [API keys and embedding](https://docs.fanfare.io/guide/account/developer.md).

## How styling works on your site

* **Your brand:** Applies automatically once a customer enters the experience. To style pre-entry screens (such as **Get started** and sign-in), ask your developer to pass your brand config to the widget. See [Set your brand](https://docs.fanfare.io/guide/create/brand.md).
* **Widget design:** Your experience's widget design applies on your site unless your developer overrides the starting style in code. Note that the **Quick start** snippet includes the **Rounded** starting style—ask your developer to remove it if you want your Design Studio style to control the look. Assigning a custom widget design beyond your default requires Growth or above; see [Templates and widget designs](https://docs.fanfare.io/guide/create/templates.md).
* **Experience colours:** Any overrides set on the experience's **Design** tab under **Experience colours** apply automatically on your site. See [Brand, templates, and designs](https://docs.fanfare.io/concepts/design.md).
* **Custom site styling:** Theme styling passed directly by your developer in code overrides your brand, widget design, and experience colors.
* **Brand fonts:** Display when loaded by your website or when widget font loading is enabled (included in the **Quick start** snippet). See [Set your brand](https://docs.fanfare.io/guide/create/brand.md).

## What changes without a published hosted page

If you run a drop exclusively on your own website—or if your organization's drop-page address isn't active—messages and posts that normally link to a Fanfare-hosted page behave differently:

* **Audience invites won't send:** Because invites require a hosted page URL, the invite displays **Needs an experience page link** (and **Needs link** on the sequence card). See [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md).
* **Access-code emails omit the button:** Codes still send, without the button linking to a hosted page. See [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md).
* **Social posts and SMS omit the link:** Scheduled posts and texts go out without a hosted page link, and Discord server events are skipped. See [Announcements](https://docs.fanfare.io/guide/create/announcements.md).
* **Purchase notifications use your Product URL:** Win notices, queue admission messages, payment reminders, and outbid alerts link to each product's **Product URL** instead (or send without a link if no **Product URL** is set). See [Add products](https://docs.fanfare.io/guide/create/products.md).

## Embed a hosted page in an iframe

If you publish a hosted page and want to display it inside an iframe on your own website, an organization admin must add your site's origin under **Settings → Embedding**. In the standalone Fanfare admin, this setting controls iframe framing only—it doesn't restrict the embedded SDK widget. See [API keys and embedding](https://docs.fanfare.io/guide/account/developer.md).

## Preview before launch

* Preview every widget state on the experience's **Design** tab under **Widget** ([Templates and widget designs](https://docs.fanfare.io/guide/create/templates.md)).
* Review every screen and notification shoppers experience in [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

## On Shopify

On Shopify, you don't need custom SDK code—add the Fanfare widget directly to your product pages as a theme app block from **Settings → Storefront setup**, and turn on Fanfare's checkout rule to protect your inventory. See [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md) and [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).

Two admin settings behave differently in the Shopify app:

* **Embedding:** Once you add a site under **Settings → Embedding**, only those listed sites and your store's own domains can access Fanfare from the browser.
* **API Keys:** Any staff member using the Fanfare app can rotate the secret key. See [API keys and embedding](https://docs.fanfare.io/guide/account/developer.md).

## Related

> [card] [Build and publish the hosted page](https://docs.fanfare.io/guide/create/hosted-page.md)
>
> Launch your drop on a dedicated Fanfare-hosted page.

> [card] [Templates and widget designs](https://docs.fanfare.io/guide/create/templates.md)
>
> Customize and preview your entry widget design.

> [card] [API keys and embedding](https://docs.fanfare.io/guide/account/developer.md)
>
> Manage API keys, secret keys, and iframe embedding allowlists.

> [card] [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md)
>
> Walk through the customer journey at every drop stage.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.