Skip to main content
Use loyalty discounts when you want the discount percentage to change based on how many orders a customer has completed. This is useful for rewarding subscribers over time, or for campaigns where specific order numbers should receive a higher discount.

​
Enable in New Features

Loyalty discounts are a preview feature. To enable them:
  1. Go to New Features in your Firmhouse project.
  2. Enable Loyalty Discounts.
  3. Go to Discounts and create or edit an order discount.
  4. Enable Loyalty discount.

​
Choose a discount pattern

Loyalty discounts support two patterns.

​
Increase every order

Choose Increase every order when the discount should start at one percentage and increase after every completed order until it reaches a maximum. Example setup:
  • Orders before loyalty discount starts: 1
  • Starting discount: 2%
  • Increase by: 1%
  • Maximum discount: 20%
With this setup, checkout order 1 receives no loyalty discount. Order 2 receives 2%, order 3 receives 3%, and the discount keeps increasing until it reaches 20%. After that, the 20% discount continues on future orders. Set Orders before loyalty discount starts to 0 if the discount should start on the first completed order, including checkout. Set it to 1 if checkout should be skipped and the discount should start on the first recurring order.

​
Specific order numbers

Choose Specific order numbers when only exact order numbers should receive a discount. Example setup:
Order numberDiscount percentage
120%
230%
550%
With this setup, order 1 receives 20%, order 2 receives 30%, orders 3 and 4 receive normal price, order 5 receives 50%, and order 6 onward resumes normal price.

​
Apply the discount

Loyalty discounts can be configured as automatic order discounts. When automatic application is enabled, Firmhouse applies the loyalty discount to eligible new subscriptions and tracks the customer’s completed order count through the applied discount. You can still use the usual eligibility settings where compatible, such as limiting the discount to specific products, collections, or plans.

​
Shopify checkout behavior

For subscriptions created through Shopify Checkout, the Shopify checkout order is created before Firmhouse can apply this loyalty discount. That means:
  • The initial Shopify checkout order does not receive a Firmhouse loyalty discount.
  • Firmhouse can apply the loyalty discount after the subscription is imported.
  • The next subscription contract order can receive the configured next loyalty discount.
For Firmhouse Checkout and API-created subscriptions, Firmhouse calculates the first order, so loyalty discounts can apply from order 1 when configured to do so.

​
Limitations and notes

  1. Loyalty discounts are percentage-based order discounts.
  2. Loyalty discounts are not combined with tiered discount settings.
  3. Advanced checkout requirements are not supported together with loyalty discounts.
  4. Missing rows in Specific order numbers mean the customer receives normal price for that order.
  5. Cancelling an order rolls back the tracked order count for the applied loyalty discount.