Basic Coupon Codes

Coupon Codes for Specific Customers

Automatic Discount for Specific Customers

MERGE: Update existing discount or create if not found

DELETE: Remove the discount from the store

NEW: Create a new discount (will fail if discount already exists)

UPDATE: Update existing discount (fails if not found)

REPLACE: Delete existing discount and create new one

IGNORE: Skip this discount row

MERGE: Add codes without removing existing ones

REPLACE: Replace all existing codes with those in the file

DELETE: Remove codes listed in the file

Amount off Products: Discount on specific products or collections

Amount off Order: Discount on the entire order total

Free Shipping: Free shipping for qualifying orders

Buy X Get Y: Purchase specific items to get others at discount or free

Code: Customers must enter a discount code at checkout

Automatic: Discount is automatically applied when conditions are met

Percentage: Discount as a percentage (e.g., 25% off)

Fixed Amount: Discount as a fixed amount (e.g., $20 off)

Free: Items are given for free (for Buy X Get Y)

None: No minimum requirement

Amount: Minimum order subtotal required

Quantity: Minimum quantity of items required

TRUE: Each customer can use the discount only once

FALSE: Customers can use the discount multiple times

Active: Currently available for use

Scheduled: Will become active in the future

Expired: No longer available for use

TRUE: This is the primary row for the discount

FALSE: This is a secondary row for additional codes or data

All: All products in the store

Specific Products: Only specified products

Specific Collections: Only products in specified collections

For whole products: Use product handles (e.g., wireless-headphones,gaming-mouse)

For specific variants: Use handle|SKU format (e.g., laptop-backpack|WH4567)

For collections: Use collection handles

Products: Specific products

Collections: Products from specific collections

Amount: Minimum dollar amount

For whole products: Use product handles

For specific variants: Use handle|SKU format

For collections: Use collection handles

Use 2-letter country codes (e.g., US,CA,AU)

Use * for "Rest of the World"

Countries must be added to at least one shipping zone

All Customers: Available to all customers

Specific Customers: Only specific customers can use

Customer Segments: Only customers in specific segments can use

If Customer Type is "Segments": Customer segment names

If Customer Type is "Customers": Customer email addresses

One-time: One-time purchases only

Subscription: Subscription purchases only

Both: Both one-time and subscription purchases

1: First payment only

Number > 1: Specific number of recurring payments

Empty: All recurring payments

TRUE: This discount can be used with product-level discounts

FALSE: This discount cannot be combined with product-level discounts

TRUE: This discount can be used with other order-level discounts

FALSE: This discount cannot be combined with other order-level discounts

TRUE: This discount can be used with shipping discounts

FALSE: This discount cannot be combined with shipping discounts

Product: Links to a specific product

Collection: Links to a product collection

URL: Links to a custom URL

id: Filter by specific discount IDs

title: Filter by discount title

code: Filter by discount code

status: Filter by discount status (active, scheduled, expired)

type: Filter by discount type

method: Filter by discount method (code, automatic)

created_at: Filter by creation date

updated_at: Filter by last update date

starts_at: Filter by start date

ends_at: Filter by end date

total_used_count: Filter by total usage count

usage_limit: Filter by usage limit

applies_once_per_customer: Filter by one-use-per-customer setting