1. What Are VIP Automatic Discounts?

When a merchant enables VIP Automatic Discounts, eligible VIP tier rewards are applied automatically at checkout. Customers no longer need to enter a discount code — the discount appears instantly based on their VIP tier.

2. Which Reward Types Can Be Automatic?

Only these 5 reward types can be delivered as automatic discounts within a VIP tier:

Reward Type	Automatic?	Notes
Percentage Off	Yes	e.g. 15% off all items
Amount Discount	Yes	e.g. $15 off all items
Free Shipping	Yes	Free shipping on the order
Order Discount	Yes	e.g. $5 off order subtotal
Free Product	Yes	100% off a specific product
Gift Card	No	Always delivered as a code
Points	No	Added to balance, not a discount

3. Combination Rules

3.1 Inside One VIP Tier

Shopify allows only ONE discount per type per tier. Different types CAN combine, but two rewards of the same type CANNOT.

Combination	Works?	Reason
Percentage Off + Free Shipping	Yes	Different types (product + shipping)
Amount Discount + Free Shipping	Yes	Different types
Percentage Off + Order Discount	Yes	Different types (product + order)
Percentage Off + Amount Discount	No	Same type (both are product discounts)
Percentage Off + Free Product	No	Same type
Amount Discount + Free Product	No	Same type

Key rule: One product discount + one order discount + one shipping discount per tier. Two product discounts in the same tier are NOT allowed.

3.2. Automatic vs Code-Based Discounts (Cross-Program)

Automatic VIP discounts CAN coexist with code-based discounts from other programs (Redeem Ways, Referral) — but with restrictions:

VIP automatic 15% + Redeem Ways free shipping code → Yes (different types)
VIP automatic 15% + Redeem Ways $10 off code on the SAME product → No (one product discount per line)
VIP automatic 15% + Redeem Ways $10 off code on DIFFERENT products → Yes (each applies to its own items)

4. Permanent-Only Limitation

Automatic discounts are always permanent. Shopify does not support one-time or limited-use automatic discounts.

Reward Setting	Can be Automatic?
Permanent	Yes
One-Time Use	No — must change to Permanent first

If a reward is set to One-Time Use, the system blocks the merchant from enabling it. They must open the reward editor, change the Discount Duration to Permanent, save, then enable.

5. Conflicts to Resolve Before Enabling

The merchant CANNOT turn on Automatic Discounts until ALL tiers are clean.

Two types of conflicts block enabling:

5.1 Same-Type Conflict

Two rewards of the same discount type are enabled in one tier.

For example: Tier "Gold" has both Percentage Off AND Amount Discount enabled.

Fix: Go to the tier and disable one of them.

5.2 One-Time Reward Conflict

A reward is set to One-Time Use. For example: Tier "Silver" has a Percentage Off reward set to One-Time.

Fix: Open the reward editor, change Discount Duration to Permanent, save.

The system shows a popup listing all conflicts with a "Fix" button that takes the merchant directly to the right page to resolve each issue.

6. Quick Troubleshooting

Customer / Merchant Says	Check This
"My VIP discount isn't applying at checkout"	Verify the customer is assigned to a VIP tier, and the automatic discount exists for that tier.
"The toggle won't turn on"	Check for same-type conflicts or one-time rewards in any tier.
"I can't enable a reward"	Is auto-apply ON? Does the tier already have a same-type reward enabled? Is the reward One-Time?
"Code discount won't combine with automatic"	Same-type discounts on the same line don't combine — this is a Shopify limitation.
"Discount only shows free shipping"	The discount config may be stale. Toggle the feature OFF then ON to rebuild.

Final SET UP

Once you've made sure everything is working properly, enable the automatic discount

Step 1: Go to the Settings tab in the Casa Loyalty app.

Step 2: Go to Discount API

Step 3: Change the discount API to Native GraphQL API

Step 4: Click Save

Step 5: Enable Automatic Discount. If you get an error while saving it, please fix the error first.

If you still have any queries, feel free to reach out to support!