Skip to content

How to Create a Promotion

What This Task Does

This task creates a new promotion campaign and gets its core settings ready so you can later attach codes, conditions, and per-product benefits.

Use it when you need a new discount campaign for orders, order items, or shipping.

Before You Start

Make sure:

  • you can access Settings > Promotions
  • the promotions feature is enabled
  • you know the promotion target you need
  • you know whether the promotion will use codes, conditions, or per-product benefits

Steps

  1. Open Settings > Promotions.
  2. Create a new promotion.
  3. Enter the required fields:
    • title
    • target
  4. Save the promotion to open its detail page.
  5. On the promotion page, set:
    • promotion type
    • value
    • date range
    • shipping cutoff if needed
    • combinable setting
  6. Save the promotion changes.
  7. If the campaign should be redeemable by shoppers, add at least one promotion code next.
  8. If the campaign needs rules, add conditions.
  9. If the promotion type is per product, add the required product benefits.

What Happens Next

After this task:

  • the campaign exists in the promotions list
  • the promotion can be activated and completed with codes and conditions
  • storefront discounts still depend on code redemption and eligibility

Common Mistakes

  • Creating the promotion but never adding a code for a code-driven campaign.
  • Picking the wrong target before the promotion type is configured.
  • Forgetting to activate the promotion after the setup is complete.
  • Expecting a per product campaign to work without configured benefits.

Sources

  • packages/admin/src/Livewire/Admin/Settings/Promotions/CreateDialog.php
  • packages/admin/src/Livewire/Admin/Forms/PromotionForm.php
  • packages/admin/src/Livewire/Admin/Settings/Promotion/BasicInformationBlock.php
  • packages/admin/resources/views/components/settings/promotion/page.blade.php