Integration · Any website (HTML)

How to embed live falling-price drops on any website

The short answer

To embed Freefall drops on any website, add the Freefall script tag once and place a freefall-market element where the drops should appear. It works on any site that lets you add HTML, from hand-built pages to React and other frameworks, and updates live.

Embedding needs the Trader plan or higher. Every plan includes a hosted Freefall page you can link to from any site. Compare plans

Step by step

  1. Create your store and first drop. Sign up, create a store and add a drop with its starting price, floor and quantity. Connect your Stripe payout account so you can take orders.
  2. Allow your website's domain. In your console, open your store's Integrate page and add your website's address (for example https://yourstore.com) under Allowed origins. Drops only load on the domains you list. Add every domain the page is served from, including staging.
  3. Load the script once. Add the Freefall script tag to the page, or once in your site's layout.
  4. Place the element. Add a freefall-market element with your store's publishable key wherever drops should appear. Use the limit attribute to choose how many drops show.

The snippet

Your Integrate page shows this with your store's key filled in.

<script src="https://freefallexchange.com/embed/v1.js" async></script>
<freefall-market store="pk_live_…" limit="6"></freefall-market>

Good to know

  • The publishable key is safe to put in your page; it can only show your published drops. Keep your secret API key on your server.
  • Listen for the element's purchase events, or use signed order webhooks, to connect orders to your own systems.

Frequently asked questions

Does it work with React, Vue or other frameworks?

Yes. freefall-market is a standard web component, so it works anywhere you can render an HTML element.

Where do shoppers pay?

In a secure Freefall checkout window that opens over your page. Shoppers lock the price, pay with a saved card, and the order appears in your Freefall console. Paid plans can also send each order to your own systems as a signed webhook.

Will the embed clash with my theme?

No. It's a self-contained web component with its own styles, so your theme's CSS can't break it, and it picks up your store's accent colour.

Other ways to sell

Start selling live drops.

Free on one store with unlimited live drops. Your first drop can be live in minutes.