Offer a free product via a discount code

Note: Tiered Discounts is a preview feature. The Firmhouse team must enable the Tiered Discounts for your project.

Important: The discount code does not add the free product to the cart. The customer must add the gift product to the cart themselves as a one-time purchase. If the product is missing from the cart, Shopify can show the code as valid but not applicable.

​

1. Create a manual Tiered Discount

1. Go to Discounts in your Firmhouse portal.
2. Create a new Discount.
3. Keep the discount Manual.
4. Enable Enable discount tiers.
5. Select the Purchase type for the products that should qualify for this tier:
   • Both: subscription and one-time purchase products can qualify.
   • Subscription only: only subscription products can qualify.
   • One-time purchase only: only one-time purchase products can qualify.
6. Add a tier and set the Minimum quantity the cart must contain before the discount can become active.
7. Optionally add a product or collection scope to limit which products count toward the minimum quantity.

Important — choose how the free product is unlocked: Tiered discounts work in two ways, and both make the product free once it’s in the cart, and the tier’s minimum quantity is met:

• Manual + discount code: Keep the discount Manual and link a discount code to it. The free product is only unlocked when the customer enters that code at checkout.
• Automatic: Set the discount to Automatic and no code is needed. The product becomes free for any customer whose cart qualifies, as soon as it’s added and the minimum quantity is met.

​

2. Add the free product under Customer gets

1. In the tier, go to Customer gets.
2. Click + Add discount and select One-time product discount.
3. Select the one-time purchase product or collection that customers can receive for free.
4. Set the quantity customers should receive.
5. Set the discount type to free.
6. Save the discount.

Important: The gift must be a one-time purchase product. Do not select a subscription product as the free gift.

​

3. Create the discount code

1. Go to Discount Codes in your Firmhouse portal.
2. Create a new discount code.
3. Enter the code customers should use at checkout.
4. Select the manual tiered discount you created.
5. Save the discount code.

​

4. Confirm the discount is active

1. Go back to Discounts.
2. Open the tiered discount.
3. Review the tier and Customer gets configuration.
4. Confirm the discount is Active before sharing the code with customers.

​

5. Test the code in the Shopify checkout

1. Add the qualifying subscription products to the Shopify cart.
2. Add the gift product to the cart as a one-time purchase.
3. Go to checkout.
4. Enter the discount code.
5. Confirm that the gift product line is discounted to 100% off.

Important: If the gift product is not already in the cart as a one-time purchase, Shopify can accept the code but show it as not applicable because there is no matching cart line to discount.

​

Troubleshooting

​

Shopify says the code is valid but not applicable

• the customer added the gift product to the cart themselves
• the gift product is in the cart as a one-time purchase
• the gift product matches the product or collection configured under Customer gets
• the cart meets the tier’s minimum quantity and product or collection scope
• the tiered discount is active in Firmhouse

​

The discount applies without entering a code

​

The free product is not 100% off

​

Tiered Discounts are not visible in your project

​

Related articles

• Tiered discounts for multiple products
• Manage discount codes