> ## 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.

# Set up an auction

> Run an English or Dutch auction, configure pricing and settlement timing, and know what locks once bidding opens.

An auction lets shoppers bid for scarce items—either driving the price up until the highest bidder wins (English) or starting high and stepping down on a schedule until buyers jump in (Dutch). You can launch an auction with a new experience or add one to an existing sequence.

For how bidding, settlement, reserve prices, and unpaid wins work, read [Auction](https://docs.fanfare.io/concepts/distributions/auction.md).

## Before you start

* **Checkout support:** Your checkout must be able to charge the winning bid. Auctions are included on every Fanfare plan—if the **Auction** card shows **"Needs a checkout that charges the winning bid"**, upgrading won't unlock it. Switch to **Fanfare checkout** or connect a checkout that supports auction pricing in your organization's currency. See [Checkout options](https://docs.fanfare.io/concepts/checkout-options.md), or [On Shopify](https://docs.fanfare.io/guide/create/auction.md#on-shopify) if you're using the Shopify app.
* **Currency lock:** Your organization's currency can't be changed while any undeleted auction exists, or while a winner from an ended auction is still inside their payment window (even if you've deleted that auction). See [Organization settings](https://docs.fanfare.io/guide/account/organization.md).
* **Allocated stock:** Make sure the sequence holds units—adding an English auction to a sequence with zero units causes it to open sold out. See [Allocate stock to a drop](https://docs.fanfare.io/guide/create/stock-allocation.md).

Auctions don't have a **Payment** step: winners always pay after winning, and shoppers always enter by placing a bid (no guest access or automatic entry).

## Choose English or Dutch

| Type | How pricing works | Key settings |
| - | - | - |
| **English** | Price rises with each bid; the highest bidder wins when the auction settles. | **Reserve Price**, **Minimum Bid Increment**, auto-extend |
| **Dutch** | Starts at **Start Price** and drops by **Price Drop Amount** each interval, never below **Floor Price**. At settle, the price freezes where it stands. | **Start Price**, **Floor Price**, **Price Drop Amount**, **Price Drop Interval (seconds)**, quantity |

> [!WARNING]
>
> **Auction type is permanent.** Once you create an auction, you can't switch between English and Dutch—create a new auction instead.

## Create an auction with a new experience

Shared wizard steps and default times are covered in [Create an experience](https://docs.fanfare.io/guide/create/experiences.md). Here's what's specific to an auction:

**1. Choose Auction**

Open **Experiences**, select **Create Experience**, and choose **Auction**.

**2. Set products and schedule**

On **Configure Experience**, pick your products, enter an **Experience Name**, and set **Time Zone**, **Opens At**, **Closes At**, and **Settles**. **Settles** is when bidding ends and must fall between **Opens At** and **Closes At**.

**3. Allocate stock**

On **Stock**, enter units per size. A Dutch auction sells the total across sizes. An English auction ignores the quantities you type and assigns one unit of each size to the sequence.

**4. Pick the auction type and pricing**

On **Auction Configuration**, choose **English auction** or **Dutch auction**, then review and adjust the pricing fields (see the tables below).

**5. Set access and create**

Complete **Access** and **Review & launch**, then select **Create experience**.

## Add an auction to an existing sequence

1. Open your experience, then open the sequence you want to add to.
2. On the **Overview** tab, select **Add distribution** in the **Distributions** card.
3. Enter a **Name**, choose **Auction**, and select **Next**.
4. On **Schedule**, set **Opens**, **Closes**, **Time zone**, and **Settle at** (same field as **Settles** in the wizard and **Edit**). Windows in the same sequence can't overlap—see [Distributions](https://docs.fanfare.io/concepts/distributions/overview.md).
5. On **Configure**, choose **English (ascending)** (selected by default) or **Dutch (descending)** under **Auction Type**, then fill in your pricing fields and select **Next**.
6. Review your settings and select **Create Distribution**.

To reuse an existing auction's configuration, select **Duplicate** from its card menu. See [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md).

![The Auction type choice with two cards, English auction and Dutch auction, each listing its pricing fields, with the pair outlined.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/guide-create-auction-type.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=b2d9d987b00916950a250d6d26ddd262)

Select English or Dutch auction to configure its pricing rules.

> [!NOTE]
>
> **Leave room for auto-extend:** If you turn on auto-extend, **Settle at** (or **Settles**) must leave at least the full extension length before **Closes**. A late bid extends the auction once by that duration, and never past **Closes**.

> [!NOTE]
>
> **Check prefilled wizard prices:** **Add distribution** leaves price fields blank, while the experience wizard prefills starting values from a base price (the lowest price of your first selected product, or `100` if unpriced): **Reserve Price** and **Floor Price** default to the base price, **Start Price** to 1.5× the base price, **Minimum Bid Increment** to `5`, and **Price Drop Amount** to `10` every `5 minutes`. Review every price before creating your auction.

## English auction settings

| Setting | What it does | Default | Editable once live? |
| - | - | - | - |
| **Reserve Price** | Minimum winning bid. If the highest bid stays below it, nobody wins. Optional. | Wizard: base price; **Add distribution**: blank | No |
| **Minimum Bid Increment** | Minimum amount each new bid must beat the current bid by (in the wizard, at least your currency's smallest unit, like `0.01` USD). Optional. | Wizard: `5`; **Add distribution**: blank | No |
| **Auto-Extend** and **Extension Duration** (wizard) / **Auto Extend Seconds** (**Add distribution** and **Edit**) | Gives late bidders extra time. A bid placed within this window before **Settles** pushes **Settles** out once by the same length (never past **Closes**). Choose 1, 2, 5, 10, 15, or 30 minutes in the wizard, or enter seconds elsewhere. | Off | Yes |

English auctions don't have a quantity field. On a stock-tracked sequence, the auction offers one unit of each size and the winner takes one (any extra units remain in the sequence). On an untracked sequence, it still picks one winner without deducting stock, and **Add distribution** doesn't show a units summary.

## Dutch auction settings

| Setting | What it does | Default | Editable once live? |
| - | - | - | - |
| **Start Price** | Opening price when bidding starts (must be above `0`). | Wizard: 1.5× base price; **Add distribution**: blank | No |
| **Floor Price** | Lowest price the auction can reach (can't exceed **Start Price**). Optional. | Wizard: base price; **Add distribution**: blank | No |
| **Price Drop Amount** | Amount the price steps down at each interval (must be above `0`). | Wizard: `10`; **Add distribution**: blank | No |
| **Price Drop Interval (seconds)** | How often the price drops. Pick 1, 2, 5, 10, 15, or 30 minutes in the wizard, or enter seconds (at least `1`) elsewhere. | Wizard: 5 minutes; **Add distribution**: blank | No |
| **Quantity** | Total units the auction sells. | See below | No |

How **Quantity** is set depends on where you create the auction:

* **In the wizard:** Automatically equals the total units entered on **Stock** (edit it on that step).
* **In Add distribution:** On a stock-tracked sequence, it automatically equals the sum of sizes on the sequence's **Stock** card. On an untracked sequence, enter **Quantity** manually (at least `1`).

The **Configure** step previews the price drop schedule as you enter your values.

![The Dutch auction fields in the Add Distribution dialog, with a per-size units summary totaling 24 units in place of a quantity field, and a preview of the falling price.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/guide-create-auction-dutch.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=ff3370c947c71cc880a451345e2e1e74)

On a stock-tracked sequence, a Dutch auction automatically sells the total allocated across sizes.

## Edit an auction

Open the sequence's **Overview** tab and select **Edit** on the auction card to adjust **Schedule** or **Configuration**.

> [!WARNING]
>
> **Pricing locks 30 seconds before Opens.** Once an auction approaches its open time, **Reserve Price**, **Minimum Bid Increment**, **Start Price**, **Floor Price**, **Price Drop Amount**, **Price Drop Interval (seconds)**, and **Quantity** can no longer be changed. To change pricing after that point, you must **Deactivate** the auction (which voids every bid and can't be undone) and create a new one. See [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md).

On a stock-tracked sequence, a Dutch auction's quantity displays as **"From allocation"** in **Edit** and tracks the sequence's **Stock** card until the auction opens.

After an auction opens, you can still:

* Move **Closes**, or move **Opens** earlier (never later)
* Adjust **Auto Extend Seconds** on an English auction
* Adjust **Settles**, as long as it stays inside the window and leaves room for any extension

Once bidding ends (at **Settles** or the end of an extension), the schedule locks completely. See [What locks, and when](https://docs.fanfare.io/concepts/what-locks-when.md) for the full lock-in timeline.

To track bids in real time, see [Watch a live drop](https://docs.fanfare.io/guide/drop/watch-live.md). For the bidder experience, see [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

## On Shopify

In the Shopify app, **Auction** stays locked with **"Needs a checkout that charges the winning bid"** (regardless of your Fanfare plan) until all four requirements are met:

* Your store is on **Shopify Plus**.
* The Fanfare app has all requested permissions in Shopify.
* The **Fanfare checkout validation** rule is turned on in Shopify's checkout settings, with **Allow all customers to complete checkout** unchecked. Fanfare won't re-enable this rule if you turn it off. See [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).
* Your Shopify store's currency matches your Fanfare organization's currency.

## Troubleshooting

> [accordion] Auction is grayed out with 'Needs a checkout that charges the winning bid'
>
> Your current checkout can't charge dynamic winning bids—upgrading your Fanfare plan won't unlock it. Switch to **Fanfare checkout** or connect a checkout that supports auction pricing in your organization's currency. Using Shopify? Check the four requirements under [On Shopify](https://docs.fanfare.io/guide/create/auction.md#on-shopify).

> [accordion] My auto-extend duration is rejected
>
> Your extension would push settlement past **Closes**. Move **Settles** (or **Settle at**) earlier, push **Closes** later, or shorten the extension length.

> [accordion] The price fields are grayed out when editing
>
> Pricing changes are refused starting 30 seconds before **Opens**, and the price fields become disabled once the auction opens. If pricing must change, deactivate the auction and create a new one.

> [accordion] I can't get past the Dutch auction settings
>
> Your stock allocation is missing units. In the wizard, select **Go to Stock** and enter units for each size. In **Add distribution** on a stock-tracked sequence, give every size a unit count on the sequence's **Stock** card so the total is above zero.

## Related

> [card] [Auction](https://docs.fanfare.io/concepts/distributions/auction.md)
>
> How English and Dutch auctions run, settle, and pick a winner.

> [card] [Allocate stock to a drop](https://docs.fanfare.io/guide/create/stock-allocation.md)
>
> Set the units per size that an auction sells.

> [card] [Watch a live drop](https://docs.fanfare.io/guide/drop/watch-live.md)
>
> Follow bids and extensions while an auction runs.

> [card] [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md)
>
> Deactivate an auction and learn when Fanfare blocks deactivation.


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