Import Coupons

Import discount coupons into WooCommerce from external sources

Overview

Coupon imports allow you to migrate discount coupons from another store, import coupon lists from external systems, or bulk create coupons for promotions.

PrimeLink imports all coupon settings including discount type, amount, usage limits, expiration dates, and restrictions.

Coupon Fields Overview

Basic Information

  • Coupon Code: The coupon code customers enter (required)
  • Description: Coupon description
  • Status: Published, Draft, etc.
  • Discount Type: Percentage, Fixed cart, Fixed product

Discount Settings

  • Coupon Amount: Discount amount (percentage or fixed)
  • Free Shipping: Allow free shipping
  • Exclude Sale Items: Exclude items on sale

Usage Limits

  • Usage Limit per Coupon: Total times coupon can be used
  • Usage Limit per User: Times each user can use coupon
  • Limit Usage to X Items: Limit to specific number of items

Restrictions

  • Minimum Amount: Minimum order amount
  • Maximum Amount: Maximum order amount
  • Allowed Products: Specific products coupon applies to
  • Excluded Products: Products coupon doesn't apply to
  • Allowed Categories: Categories coupon applies to
  • Excluded Categories: Categories coupon doesn't apply to
  • Allowed Email Addresses: Emails that can use coupon
  • Excluded Email Addresses: Emails that cannot use coupon

Expiration

  • Expiry Date: Coupon expiration date

Import Process

Step 1: Welcome

Start the coupon import wizard from PrimeLink → Imports → New Import → Coupons

Step 2: Select Data Source

Choose where your coupon data is coming from

Step 3: Import Strategy

Choose how to handle existing coupons:

  • Create & Update: Create new coupons and update existing ones
  • Create Only: Only create new coupons, skip existing
  • Update Only: Only update existing coupons, skip new ones

Step 4: Filters & Preview

Filter your coupon data and preview results

Step 5: Field Mapping

Map source fields to WooCommerce coupon fields:

  • Map coupon code and description
  • Map discount settings
  • Map usage limits and restrictions
  • Map expiration dates

Step 6: Options & Scheduling

Configure import options and scheduling

Step 7: Review

Review your import configuration

Step 8: Run Import

Start the import and monitor progress

Matching Coupons

Matching Criteria

When updating existing coupons, PrimeLink needs to match them. Available options:

  • Coupon Code: Match by coupon code (recommended)
  • Coupon ID: Match by WooCommerce coupon ID
  • Custom Field: Match by custom field value

Best Practices

  • Use Coupon Code for matching (most reliable)
  • Ensure coupon codes are unique
  • Use Coupon ID if importing from another WooCommerce store

Discount Types

Percentage Discount

  • Discount type: percent
  • Amount: Percentage value (e.g., 10 for 10%)
  • Example: 10% off order

Fixed Cart Discount

  • Discount type: fixed_cart
  • Amount: Fixed amount (e.g., 10.00 for $10 off)
  • Example: $10 off entire cart

Fixed Product Discount

  • Discount type: fixed_product
  • Amount: Fixed amount per product
  • Example: $5 off each product

Product and Category Restrictions

Allowed Products

Restrict coupon to specific products:

  • Map to "Allowed Products" field
  • Multiple products separated by comma
  • Use product IDs or SKUs
  • Example: 123,456,789 or SKU-001,SKU-002

Excluded Products

Exclude specific products from coupon:

  • Map to "Excluded Products" field
  • Multiple products separated by comma
  • Use product IDs or SKUs

Allowed Categories

Restrict coupon to specific categories:

  • Map to "Allowed Categories" field
  • Multiple categories separated by comma
  • Use category IDs or names
  • Example: Electronics,Computers

Excluded Categories

Exclude specific categories from coupon:

  • Map to "Excluded Categories" field
  • Multiple categories separated by comma
  • Use category IDs or names

Best Practices

  • Use unique coupon codes: Ensure each coupon has a unique code
  • Test with sample data: Run a test import with a few coupons first
  • Verify discount amounts: Check discount amounts are correct
  • Set expiration dates: Use expiration dates for time-limited promotions
  • Backup first: Always backup your store before large imports
  • Check usage limits: Verify usage limits are appropriate
  • Validate restrictions: Ensure product/category restrictions are correct

Common Issues and Solutions

Coupons Not Created

  • Check required fields are mapped (Coupon Code is required)
  • Verify coupon code format is correct
  • Check import logs for specific errors
  • Ensure coupon codes are unique

Discount Not Applied

  • Verify discount type is correct
  • Check discount amount format (numbers only)
  • Ensure restrictions allow the coupon to be used
  • Check expiration date hasn't passed

Product Restrictions Not Working

  • Verify product IDs or SKUs are correct
  • Check products exist in your store
  • Ensure product separator is correct
  • Verify restriction type (allowed vs excluded)

Next Steps

📦 Import Products

Learn how to import products

Learn More →
🗺️ Field Mapping

Detailed guide to field mapping

Learn More →
📥 Creating Imports

Complete import process guide

Learn More →