Skip to content

Quick Checklist: Promotion Application ​

When To Use This Checklist ​

Use this checklist when a promotion code exists but does not apply in cart, or when a promotion campaign looks configured but still does not discount the order.

Promotion Status ​

  • [ ] The promotion is active.
  • [ ] The promotion is not still scheduled.
  • [ ] The promotion is not already expired.
  • [ ] The promotion date range matches the order you are testing.

Code And Rules ​

  • [ ] The promotion code exists and is spelled correctly.
  • [ ] The code has not reached its usage limit or per-customer usage limit.
  • [ ] The promotion target matches the expected discount behavior:
    • order
    • order items
    • shipping
  • [ ] If the promotion is per product, the required benefit rows exist.

Eligibility ​

  • [ ] The order still satisfies the promotion conditions.
  • [ ] Shipping cutoff rules are not blocking the order.
  • [ ] Another applied promotion is not blocking this one through non-combinable rules.

Retest ​

  • [ ] Re-apply the code from the storefront cart after correcting the setup.

Use The Full Guide When ​

Use the full walkthrough when the quick checks do not explain the failure:

Sources ​

  • packages/storefront/src/Livewire/Storefront/Cart/PromotionSection.php
  • packages/framework/src/Services/Promotion/PromotionEligibilityService.php