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/admin/src/Livewire/Admin/Settings/Promotions/Row.php
  • packages/admin/src/Livewire/Admin/Settings/Promotion/Conditions/Block.php
  • packages/admin/src/Livewire/Admin/Settings/Promotion/Benefits/BenefitsList.php
  • packages/storefront/src/Livewire/Storefront/Cart/PromotionSection.php
  • packages/framework/src/Services/Promotion/PromotionEligibilityService.php