Skip to main content

Creating Coupons

Store administrators can create and manage coupons through the Coupons section in the control panel. The interface provides a comprehensive view of all existing coupons and allows for creation of new ones.

The coupon creation flow uses a modal with sections for basic information, application settings, usage restrictions, and expiration configuration.

  1. Click "New Coupon" to open the modal "Create New Coupon".
  2. Complete the sections marked with (*):
    • Basic Information
    • Coupon Application
  3. Optionally configure:
    • Usage Restrictions
    • Expiration
  4. Click "Create Coupon" to save, or "Cancel" to close without saving.

Basic Information​

Required Fields​

  • Code*: Enter a custom code or use the generator button to create a unique code automatically. Allowed characters: letters, numbers, dot (.), hyphen (-), and underscore (_). Codes are normalized to uppercase slug on save.
  • Discount (%): Percentage with up to 2 decimals. Typical ranges:
    • Subscriptions with limited discount periods: 0.01–99.99%
    • Otherwise (no subscriptions or unlimited periods): 0.01–100%

Coupon Application​

Choose where the coupon can be used (multiple selections are allowed):

  • Individual Sales: Applies to one-time product purchases.
    • When enabled, a product selector appears: “Select products or leave empty for all products”.
  • Subscriptions: Applies to subscription plans.

If enabled, you can optionally restrict the coupon to specific items (issues/plans). Leaving selectors empty makes it valid for all items of the selected type(s).

Usage Restrictions (Optional)​

These limits are optional and can be combined (0 means unlimited):

  • Total usage: Maximum total redemptions allowed for the coupon.
  • Uses per user: Maximum redemptions per user.
  • Uses per publication: Maximum redemptions per individual publication.
  • End-of-redeem-month expiration: When enabled, redemptions made with this coupon expire at the end of the current month (affects the access granted, not the coupon code itself).

Expiration (Optional)​

  • Valid until: Optional expiration date after which the coupon cannot be used.
  • Discounted periods (subscriptions): Choose unlimited or a number of periods. If limited, the maximum discount is 99.99%.

Management Actions​

The coupon management interface provides several actions:

  • Create coupon: Save a new coupon using the modal.
  • Cancel: Discard changes and close the modal.
  • Edit: Modify existing coupon settings.
  • Delete/Disable: Soft-delete a coupon. Inactive coupons show in the list and cannot be used.
  • Bulk create: If enabled for the tenant, generate multiple coupons at once.
  • Export: Access export options for coupon data from the list view.

Coupon List View

The main coupon management screen displays a table with all coupons, including:

  • Coupon code
  • Discount (percentage)
  • Status (Active, Inactive, Expired)
  • Creation date
  • Valid until (if configured)
  • Usage count (used/limit)
  • Application scope
  • Row actions (menu)

Export Options

The export dropdown includes:

  • Coupons Configuration (Excel): Detailed spreadsheet of all coupons and their configuration
  • Per-Coupon Usage (Excel): Transaction-level report for a selected coupon
  • Overall Usage (Excel): Transaction-level report across all coupons

Exports are generated asynchronously and delivered by email with a time‑limited download link. For fields and formats, see Export Reports.

Best Practices

Code Generation​

  • Use auto-generated codes for uniqueness
  • Follow consistent naming conventions for manually created codes
  • Consider readability for codes that will be manually entered
X

Graph View