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

# Minimum order amount

The minimum order amount feature lets you set a threshold that must be reached before an order can be processed.

> **Good to know:** The minimum order amount **includes taxes**, but **excludes discounts and shipping costs**. Set the amount to `0` if you want to allow orders of any amount.

You can use the minimum order amount to make sure that:

* customers using Firmhouse Checkout can only complete checkout once the threshold is met
* recurring orders are skipped until the threshold is met

## Setting it up in the Portal

You can configure the minimum order amount in **Settings > Subscription model > Minimum order amount**.

<img src="https://mintcdn.com/firmhousebv/dE5H2KMQTvd0k7qC/images/minimum-order-amount-settings.png?fit=max&auto=format&n=dE5H2KMQTvd0k7qC&q=85&s=8f6caa2d9e733b37eaf7cf65a597bffa" alt="Minimum order amount settings" width="2190" height="1232" data-path="images/minimum-order-amount-settings.png" />

### Default minimum order amount

The **Default minimum order amount** is used for all orders unless a country-specific amount is configured for the subscription's country.

1. Go to **Settings > Subscription model**
2. Find the **Minimum order amount** section
3. Enter the default minimum amount
4. Click **Update project**

### Country specific minimum order amounts

If your project uses country-specific prices, you can also override the default minimum order amount per country.

1. In the same section, find **Country specific minimum order amounts**
2. Click **Add new minimum order amount**
3. Select the country you want to override
4. Enter the minimum amount for that country
5. Click **Update project**

If no country-specific amount is set for a country, the default amount is used.

See [Country specific prices](/configure/international-and-markets/country-specific-prices) for more information about per-country pricing in Firmhouse.

## The experience in Checkout

If you are using **Firmhouse Checkout**, customers will see a warning in the checkout price breakdown when the initial order total does not reach the configured minimum. In that case, checkout cannot be completed until the threshold is met.

If you are using **Shopify Checkout**, this checkout-specific warning is not shown there.

## The experience in the Self Service Center

If an active subscription's next order does not reach the minimum, the recurring order will be skipped until the threshold is met. Customers will see a warning in the Self Service Center so they know they need to add more products before the next order can go out.

If you allow customers to manage products on their own subscription, they can use the Self Service Center to add more products and reach the minimum order amount. See [Allow customers to add products](/configure/my-account-portal/allow-customers-add-products).

<img src="https://mintcdn.com/firmhousebv/dE5H2KMQTvd0k7qC/images/minimum-order-amount-ssc-warning.png?fit=max&auto=format&n=dE5H2KMQTvd0k7qC&q=85&s=7aea6152c11695b11bb87d48f4663b6f" alt="Minimum order amount warning in the Self Service Center" width="2190" height="1232" data-path="images/minimum-order-amount-ssc-warning.png" />

## The experience in the Firmhouse Portal

If a subscription's next scheduled order is below the configured minimum, Firmhouse shows a warning on the subscription detail page in the Portal.

The notification looks like this:

> **Next order below minimum amount**\
> The next order's subtotal of **€27.55** is below the minimum order amount of **€50.00**. The order will not be shipped until the minimum is reached.

The amounts shown in the warning depend on the subscription and the configured minimum order amount for that country.

<img src="https://mintcdn.com/firmhousebv/dE5H2KMQTvd0k7qC/images/minimum-order-amount-portal-warning.png?fit=max&auto=format&n=dE5H2KMQTvd0k7qC&q=85&s=601134601063575655650c4b973bf4dd" alt="Minimum order amount warning in the Firmhouse Portal" width="2190" height="1232" data-path="images/minimum-order-amount-portal-warning.png" />

## Emails

Firmhouse sends the **Upcoming order notice** email even when the minimum order amount has not been reached yet. In the email configuration for this email, Firmhouse shows a reminder that you can use Liquid tags to adjust the copy for orders that are still below the threshold.

<img src="https://mintcdn.com/firmhousebv/dE5H2KMQTvd0k7qC/images/minimum-order-amount-upcoming-order-email.png?fit=max&auto=format&n=dE5H2KMQTvd0k7qC&q=85&s=79fe6b0e1cf2cffafd666f2de1c8aacd" alt="Upcoming order notice email configuration" width="2190" height="1232" data-path="images/minimum-order-amount-upcoming-order-email.png" />

You can use `{{project.minimum_order_amount}}` together with `{{order.minimum_order_amount_reached?}}` in your email templates to show different copy depending on whether the threshold has been met:

```liquid theme={null}
{% if order.minimum_order_amount_reached? %}
  Your next order is scheduled to ship in 7 days.
{% else %}
  Your order is scheduled for 7 days from now, but it's currently below the minimum of {{project.minimum_order_amount}}.
{% endif %}
```

See [Conditionally disable emails](/configure/customer-communication/conditionally-disable-emails) and [Liquid tags](/configure/customer-communication/liquid-tags) for more examples.
