Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.cartble.com/llms.txt

Use this file to discover all available pages before exploring further.

Cartble’s discount engine lets you run targeted promotions without a third-party app. You can create coupon codes that customers enter at checkout, or define automatic promotions that apply silently the moment a customer’s cart qualifies. Every discount rule is fully configurable — from the type of value it applies, to which products it covers, to how many times it can be used before it expires.

​
Discount methods

Every discount rule uses one of two methods to reach the customer’s cart.

Manual Coupon

You generate a code (e.g., VIP20 or SUMMER50) and share it with customers. The discount is applied only when the customer enters the code at checkout.

Automatic

No code required. Cartble evaluates the rule against the cart automatically — if the cart meets all conditions, the discount is applied instantly without any customer action.

​
Discount types

TypeHow it worksExample
PercentageReduces the eligible subtotal by a percentage.20% off all products
Fixed AmountDeducts a flat monetary value from the eligible subtotal.10offordersover10 off orders over 50
Free ShippingWaives the shipping fee when conditions are met.Free shipping on orders over $75

​
Application scope

When you create a discount, you choose which products it applies to.
The discount applies to every item in your store. This is the broadest scope and is ideal for sitewide sales or welcome promotions.
Limit the discount to a specific product category type. Available blueprint types are:
  • Physical Products — retail goods
  • Digital Products — downloadable files or links
  • Services & Bookings — appointment-based offerings
  • Subscription Clubs — recurring subscription products
Use this scope when running a promotion that should apply only to one vertical, such as “20% off all subscriptions.”
Hand-pick exactly which products are eligible. Select individual product IDs from your catalog. This is the most targeted scope and prevents the discount from being used on anything outside your selection.

​
Conditions and prerequisites

Add minimum thresholds to ensure a discount is only applied when the cart meets a baseline requirement.
ConditionDescription
Minimum cart subtotalThe cart must reach a set monetary value before the discount activates (e.g., $50 minimum).
Minimum item quantityThe cart must contain at least a specified number of eligible items.
You can combine both conditions on a single rule — for example, require at least 3 items and a $30 subtotal.

​
Usage limits

Control how many times a discount can be redeemed to protect your margins.

Global usage limit

Set a maximum number of times the discount can be used across all customers combined (e.g., 100 total uses). Set to 0 for unlimited uses.

One per customer

Toggle Yes (1 per Email) to ensure each customer email address can only redeem the discount once, regardless of how many orders they place.

​
Date range

Every discount can have a start date and an optional end date.
  • The discount becomes active at the start date and time you configure.
  • If you set an end date, the discount automatically deactivates after that date — no manual intervention required.
  • Leave the end date blank to keep the discount active indefinitely (subject to usage limits).

​
Active / Inactive toggle

Use the Active in Store / Paused / Inactive toggle to enable or disable a discount rule at any time, regardless of its date range or usage count. This is useful for quickly pausing a promotion during an incident or staging a rule before its start date.

​
Creating a new discount

1

Open Discounts

From your admin dashboard, navigate to Discounts in the left sidebar.
2

Create a new rule

Click the New Discount button in the top-right corner of the Discounts page.
3

Choose the method

Select Manual Coupon if you want customers to enter a code, or Automatic if the discount should apply without a code. If you choose Manual Coupon, enter a code in the Coupon Code field or click Generate random code to have Cartble create one for you.
4

Set type and value

Choose Percentage (%), Fixed Amount ($), or Free Shipping from the Discount Type selector. For percentage and fixed-amount types, enter the discount value in the corresponding field.
5

Define scope and conditions

Select the application scope (all products, by product type, or specific products). Optionally set a minimum subtotal or minimum quantity under Minimum Prerequisites.
6

Configure limits and dates

Set a global usage limit and toggle per-customer restrictions if needed. Enter the start date and, optionally, an end date.
7

Set status and save

Choose Active in Store to make the discount live immediately, or Paused / Inactive to save it without activating. Click Create Discount to save the rule.
Give each discount an Internal Title that clearly describes its purpose (e.g., “Black Friday 20% OFF” or “Free Shipping South”). This title is only visible to you in the admin dashboard — customers only see the code or the discount line on their cart.

​
Discount status labels

After creation, each discount in your list displays a status badge:
BadgeMeaning
ActiveThe rule is live and currently accepting redemptions.
PausedThe rule exists but has been manually disabled.
ExpiredThe end date has passed.
ExhaustedThe global usage limit has been reached.