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

# Give discounts on subscriptions

> Offer percentage or fixed discounts on initial and recurring payments in Firmhouse, including time-limited offers like 20% off the first three months.

Firmhouse allows you to give discounts to your customers that apply to both initial and recurring payments. For example, you could offer a 20% discount on the first 3 months of a subscription, or a 10% discount on the first two orders.

## How to give discounts

Discounts in Firmhouse work like this:

1. Create a discount
2. Apply it to a plan, to a customer, or create a discount code

### 1. Creating a discount

Click on "Discounts" in the sidebar. Here you can create, edit, activate and deactivate your discounts.

![Discounts Overview](https://mintcdn.com/firmhousebv/sbqjOxTOKmPe3mQZ/images/docs-configure-discounts-giving-discounts-overview-dev-aa.png?fit=max\&auto=format\&n=sbqjOxTOKmPe3mQZ\&q=85\&s=8d97fe4a4af04cb1a538f8d54da70780)

Creating a discount is straightforward. You give it an internal name, choose a percentage or fixed amount, and set the number of times the discount should apply.

![Create Discount Form](https://mintcdn.com/firmhousebv/sbqjOxTOKmPe3mQZ/images/docs-configure-discounts-giving-discounts-create-form-dev-aa.png?fit=max\&auto=format\&n=sbqjOxTOKmPe3mQZ\&q=85\&s=277b3a0f0d67471b5e030ec949fa36fb)

> **Good to know:** If you enable **Automatically apply to all customers**, the discount applies to eligible new subscriptions. By default, an automatic discount blocks an additional discount code. You can allow code override in Firmhouse Checkout or allow a supported code alongside the automatic discount on an existing subscription when the discount allows manual combinations. You can deactivate the automatic discount at any time.

### Public descriptions and translations

Use **Public description** to choose the customer-facing discount label. For projects with multiple enabled languages, use the language selector in **Discount translations** to edit each description. These controls are also available in the Shopify discount template editor.

The first enabled language is the primary description. A blank or missing translation falls back to that description. If both are blank, Firmhouse uses the default discount label. Saving other discount settings or editing one language preserves the other translations.

New Firmhouse invoice discount lines use the subscription's language. Existing invoice lines keep the description recorded when they were created. In the Customer Portal, the translated description appears when exactly one promotion is applied; with multiple promotions, the portal uses the generic discount label.

**Shopify Checkout uses a single configured message for each discount or tier.** A basic discount synced to Shopify sends the primary public description, or the discount name when that description is blank. Tiered discounts send their configured tier messages. Shopify Checkout does not select a public-description translation based on the customer's language.

### Optional minimum invoice amount floor

When you create or edit a discount, you can optionally enable **Minimum invoice amount floor**. This lets you set a minimum invoice total that should remain after the discount is applied.

For example, if you set the floor to `99.00`, Firmhouse will reduce the discount when needed so the final invoice total does not drop below `99.00`.

Use this when you want to run a promotion but still keep a minimum charged amount on the invoice.

The floor also applies to Shopify-billed subscriptions. Firmhouse synchronizes the discount when subscription products change and retries synchronization if a billing attempt starts before it finishes. If Shopify reports a synchronization failure, review the notification for the affected subscription.

### Fixed-amount discount currencies

When creating a fixed-amount discount, choose from your project's currencies and the currencies supported by your connected Shopify store. Shopify currencies are added to the form automatically. Percentage discounts do not require a currency.

**Fixed-amount discounts apply only when the cart uses the same currency as the configured discount.** For example, a discount configured in `EUR` applies to a cart in `EUR`; it does not apply to a cart in `USD`. Recurring orders must also use the discount's configured currency.

For quantity-based offers, [tiered discounts](https://docs.firmhouse.com/configure/discounts/tiered-discounts.md) also support fixed amounts. Choose **Amount off** to subtract an amount once from the eligible items' total, or **Amount off each** to subtract it from each eligible unit. Set an amount for each tier and one currency for the discount.

### 2. Applying the discount

There are three ways to apply your newly created discount:

**Applying manually to a customer** *(Firmhouse Checkout and Shopify Checkout)*: This is the most common way to apply discounts. Click on "Customers" in the sidebar and find your customer. Click on it to open the subscriber's detail page. Scroll down to "Applied discounts" and click on "Apply discount".

**Automatic on a Plan** *(Firmhouse Checkout only)*: Go to "Plans" in the sidebar and edit the plan on which you would like to give a discount. Scroll down to "Discounts" and choose which discount should apply. If a customer signs up for that plan, the discount will be applied automatically.

**Via Discount Codes at Checkout** *(Firmhouse Checkout only)*: If you want customers to get a discount on checkout you can create discount codes that your customers can enter. See [Creating discount codes](https://docs.firmhouse.com/configure/discounts/managing-discount-codes.md) for more information. If you don't see the discount to apply, make sure the desired discount is activated and it's not set to automatically apply at checkout.

> **Using Shopify Checkout?** If you're using Shopify Checkout instead of Firmhouse Checkout, you can configure checkout promotions directly in Shopify. See [Discounts on Shopify Checkout](https://docs.firmhouse.com/configure/discounts/discounts-on-shopify-checkout.md) for more information.

## Editing a discount

To edit a discount, go to the **Discounts** view and click on **Edit** next to the discount you wish to edit. You can edit the discount type, percentage or fixed amount, currency, and **Limit discount per customer to** only if all of these conditions are met:

1. The discount is deactivated.
2. The discount has not been applied to any subscriptions yet.
3. The discount has no discount codes.
4. The discount is not assigned to any plans.

If the discount has already been applied to subscriptions, you can still edit its **Discount name**, **Public description** and translations, whether it applies automatically, and its metadata. The discount value and limits remain locked to keep applied discounts consistent.

## Discount metadata

The admin metadata editor is available when enabled for your project. GraphQL and Liquid access do not require the admin editor to be enabled.

Use metadata to store integration references or other custom information on a discount. Open an existing discount, scroll to **Metadata**, and click **Edit metadata**. Enter a JSON object and save it. Metadata can be edited on active discounts and discounts already applied to customers.

For example:

```json theme={null}
{
  "campaign": "loyalty",
  "external_id": "PROMO-123"
}
```

Developers can read `metadata` on promotions and set it through the `createPromotion` and `updatePromotion` GraphQL mutations. Updating metadata replaces the complete object: read and merge existing keys before sending an update. Send `{}` to clear it, or omit the argument to leave it unchanged. The standard metadata limits apply: up to 20 keys, with strings up to 512 characters.

In Liquid, read metadata through a promotion drop, for example `{{ applied_promotion.promotion.metadata.campaign }}` when `applied_promotion` is available in the template context.

## Deactivating a discount

If you don't need a discount anymore you can simply deactivate it. You can do that on the Discounts view by clicking on **Deactivate** next to the desired discount.

![Deactivate Discount](https://mintcdn.com/firmhousebv/sbqjOxTOKmPe3mQZ/images/docs-configure-discounts-giving-discounts-deactivate-dev-aa.png?fit=max\&auto=format\&n=sbqjOxTOKmPe3mQZ\&q=85\&s=00ef0c10de7d48cc358562308eaf119b)

If you have any questions about discount codes don't hesitate to contact us!


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