WebToffee Logo
  • Home
  • Plugins
  • Bundles
  • Blog
  • Documentation
  • Support
Login
0

  • Getting Started
    • Plugin set up
  • Advanced Coupon Options
    • Display coupons using shortcodes
    • Giveaway Products
    • Automatically Apply Discount to Cart
    • Exclude Coupons/Store Credit from Applying
    • Coupons based on Shipping/Payment Method/Location
    • Restrict Auto Apply Coupons
    • Gift coupons on product purchase
    • Setup 'Seasonal discount offer'
    • Combo Coupons
  • Store Credit
    • Set up store credit
    • Gift via store credit
    • Hide My Coupons & My Store Credit
  • Bulk Generate
    • Bulk Generate Coupons
  • Import Coupons
    • Bulk import coupons
    • Coupon Generator and Importer
  • BOGO discounts
    • Buy X and get X for 50% OFF
    • Set up BOGO
    • Quantity/Volume Discount Coupon
    • Spend $X and get Y at discount
  • Nth Order Discount
    • First order coupon
    • Offer nth order discount
  • Abandoned Cart Discount
    • Offer abandoned cart discount
  • Sales Countdown Timer
    • Set up sales countdown timer
  • FAQ
    • Hide coupon code field
  • Changelog
    • Version 2.0.7
  • Signup Coupons
    • Setup signup coupon

Documentation/Smart Coupons for WooCommerce/Importing coupons in bulk using a CSV file

Importing coupons in bulk using a CSV file

Last updated on February 8, 2023

Smart Coupon for WooCommerce is an ideal solution for importing coupons to your WooCommerce store. You can import any number of coupons using a single CSV file.

Let us see how coupons are imported in bulk using a structured CSV file.

Get started

  • First of all, install and activate the plugin.
  • From your WordPress dashboard, go to the Smart Coupons > Import Coupons.

Accepting coupon data

The coupon column headers of the CSV and their expected values are explained below.

Download a Sample Coupon CSV.

Column/Tag HeaderAccepted value or formatRequiredDefaultExplanation
post_titletextYesn/aUnique coupon code used to identify a coupon. Checks for matching title to exclude an existing coupon from getting imported.
post_excerpttext/HTMLNon/aOptional coupon description
post_statusdraft/publishNoIndicates whether the coupon is in draft mode or published.
post_parentnullNoProduct parent id of grouped/variable products – no need in case of coupons
menu_ordernullNoProduct order list numerical/alphabetical in store (no need in case of coupons)
post_datedateNoCoupon created date
_wt_sc_shipping_methodsflat_rate, free_shipping, local_pickupNoRefers to shipping method of the product purchased. Coupon will be applied only if any of the selected shipping methods are opted. which can be interprested as, If the value is empty, there is no shipping method restriction for the current coupon.
_wt_sc_payment_methodscod, bacs etcNoRefers to payment method of the product purchased. The coupon will be applied only if any of the selected payment methods are opted.
_wt_sc_user_rolesadministrator, subscriber, customer, shop_manager, editor, author, contributorNoThe coupon will be applied only if the logged-in user matches the same role/capability as chosen.
_wt_category_conditionor, andNo‘or’Coupon will be applied only if the cart satisfies the product categories mentioned in this field under two condition such as any of the product or all of the products.
or: Applies coupon if the eligible quantity of products from any of the selected product categories are available in the cart.
any: Applies coupon if the cart contains the eligible quantity of products from all the listed product categories
_wt_product_conditionor, andNo‘or’Coupon will be applied only if the cart satisfies the product categories mentioned in this field under two condition such as any of the product or all of the products.
or: Applies coupon if any of the products from the below is available in the cart.
and: Applies coupon if the cart contains all the listed products.
_wt_free_product_idsInteger (product ids)NoIndicates the free product seller intends to use as giveaway along with the coupon (except BOGO coupon).
When the coupon is applied, specified quantity of product/s is added to customer cart as free product and in case of multiple products the customer will have to choose one from the list.
_wt_min_matching_product_qtyintegerNoRefers to the minimum quantity of products that matches the specifies product/category restrictions. Total number of products are considered in the absence of product/category restrictions.
_wt_max_matching_product_qtyintegerNoRefers to the maximum quantity of products that matches the specifies product/category restrictions. Total number of products are considered in the absence of product/category restrictions.
_wt_min_matching_product_subtotalintegerNoRefers to the minimum price subtotal of products that matches the specifies product/category restrictions.
_wt_max_matching_product_subtotalintegerNoRefers to the maximum price subtotal of products that matches the specifies product/category restrictions.
discount_typepercent/ fixed_cart/ fixed_product/ store_credit/ wt_sc_bogoYesRefers to the type of coupon to be created.
coupon_amountIntegerNoRefers to the amount/value of the coupon (Not applicable for BOGO coupons)
individual_useyes/noNono or 0Indicates whether the coupon can be used in conjugation with other coupons or not
product_idsInteger (product id)NoThe list of product IDs that need to be in the cart to use this coupon separated by comma.
exclude_product_idsInteger (product id)NoThe list of product IDs that shouldn’t be in the cart to use this coupon.
customer_emailEmailNoThe list of email addresses to restrict this coupon to specific billing and user emails separated by commas. Customer can also use an asterisk (*) to match certain part of emails. Eg: “*@gmail.com” matches all Gmail addresses.
usage_limitIntegerNoRefers to the number of time this coupon can be used.
limit_usage_to_x_itemsIntegerNoRefers to the maximum number of individual products that the coupon can be applied discount to.
usage_limit_per_userIntegerNoRefers to the number of time this coupon can be used by an individual user. (Uses User-ID for logged-in user and billing email for guest users)
_wt_coupon_start_dateDateNoDate that coupon become valid from.
expiry_dateDateNoDate that coupon will expire. Coupon expires at 00:00 hour of mentioned date
_wt_coupon_expiry_in_daysIntegerNoNumber of days coupon will be expired in from the start date.
_wt_sc_bogo_apply_frequencyonce/ repeatNoRefers to the number of times the coupon applies when the cart is eligible.
_wc_make_coupon_availablemy_account/ cart/ checkoutNoRefers to the pages where the coupon should be displayed at.
minimum_amountIntegerNoRefers to the minimum subtotal amount that should be spent to use the coupon.
maximum_amountIntegerNoRefers to the maximum subtotal amount that should be spent to use the coupon.
_wt_coupon_lengthIntegerNoLength of the coupon excluding prefix and suffix. (Default value is 12)
_wt_combo_coupon_can_use_withCoupon CodeNoList of coupons that can be redeemed together with the current coupon.
_wt_combo_coupon_cannot_use_withCoupon CodeNoList of coupons that cannot be redeemed together with the specified coupon.
_wt_enable_product_category_restrictionYes/noNoCoupon will apply only if the cart satisfies the product or category restrictions if enabled this.
_wt_use_individual_min_maxYes/noNoTo set minimum and maximum quantity restrictions for individual product/category instead of entire cart.
_wt_sc_coupon_product_idsintegerNoThe list of product IDs that need to be in the cart to use this coupon separated by comma.
_wt_sc_coupon_product_min_qtyIntegerNoMinimum quantity of specified product that should be in cart to apply the coupon
_wt_sc_coupon_product_max_qtyIntegerNoMinimum quantity of specified product that should be in cart to apply the coupon
product_categoriesInteger (product category ids)NoRefers to the products of specific categories that should be in the cart for the coupon to be valid.
_wt_sc_coupon_category_idsInteger (product category ids)NoRefers to the products of specific categories that should be in the cart for the coupon to be valid.
_wt_sc_coupon_category_min_qtyIntegerNoMinimum quantity of product from specified category that should be in cart to apply the coupon
_wt_sc_coupon_category_max_qtyIntegerNoMaximum quantity of product from specified category that should be in cart to apply the coupon
exclude_product_categoriesInteger (product category ids)NoRefers to the products of specific categories that should not be in cart for the coupon to be valid.
_wt_max_discountIntegerNoOption to set a cap on the discount value especially percentage coupon (eg 5% coupon on a product but with maximum of 10% discount value) ps: not applicable to BOGO, store credit.
nth_coupon_no_of_coupon_conditionequals/ greater_or_equalNoCondition of past orders on which the coupon should be validated
wt_nth_order_no_of_ordersIntegerNoNumber of past orders on which the coupon should be validated
wt_order_status_need_to_countwc-processing,wc-on-hold,wc-completed,wc-checkout-draft, wc-cancelled,wc-refunded,wc-failedNoStatus of all identified orders should match the specified eligibility.
wt_nth_order_order_totalIntegerNoMinimum total amount of all identified orders together.
_wt_product_discount_quantityIntegerNoNumber of product that should be added to cart as giveaway (not applicable to BOGO)
_wt_product_discount_amountIntegerNoRefers to the discount percentage/value of giveaway product.
_wt_product_discount_typepercent/ flatNopercentRefers to the discount type of giveaway product.
wt_apply_discount_before_tax_calculationyes/ noNo‘yes’Option to calculate tax on discounted value or total value.
_wt_sc_bogo_customer_getsspecific_product/ any_product_from_store/ any_product_from_category/ same_product_in_the_cartNospecific_productRefers to what the customers get for free or with a discount if the cart eligibility or conditions are met.Note: this field is only applicable when the coupon type is BOGO
_wt_sc_bogo_product_conditionor, andNoCondition on which the giveaway products specified will be added to cart.
or- add any from the selected products as giveaway
and – add all specified products as giveaway
_wt_sc_bogo_free_product_idsInteger (product ids)NoRefers to the product IDs that will be added as giveaway to the cart. Values are comma separated.
_wt_sc_bogo_free_product_qtyIntegerNoRefers to the quantity of giveaway product/s. Values are comma separated.
_wt_sc_bogo_free_product_priceIntegerNoRefers to the discount value/amount of giveaway product/s.Values are comma separated.
_wt_sc_bogo_free_product_price_typepercent/ flatNopercentRefers to the discount type of (BOGO) giveaway product. Values are comma separated.
_wt_sc_bogo_free_category_idsInteger (category ids)NoRefers to the category IDs of products that will be added as giveaway to the cart.Values are comma separated.
_wt_sc_bogo_free_category_qtyIntegerNoRefers to the quantity of product/s from giveaway product category. Values are comma separated.
_wt_sc_bogo_free_category_priceIntegerNoRefers to the discount value/amount of any product from giveaway category.Values are comma separated. If empty, then the value will be 100, meaning 100% discount
_wt_sc_bogo_free_category_price_typepercent/ flatNopercentRefers to the discount type of (BOGO) product from giveaway category.Values are comma separated.
_wt_need_check_location_inbilling/ shippingNoCountry should be checked in the chosen address category
_wt_coupon_available_locationcountry code (eg:US, UK)NoCoupon will be applied only if shipping or billing (as chosen) address is from specified countries.
_wt_make_auto_couponNo‘No’‘Yes’ to auto-apply coupon

Importing process

From the Import coupon tab, click on the upload button and choose a CSV file from your system.

Next, to email coupons to users specified within the CSV, tick the checkbox. The coupons will be emailed to users on import.

For a clean import, the CSV must include the header and adhere to the format as indicated in our sample file. Columns post_title and discount_type are mandatory for the import. Duplicate coupons will be skipped during import.

Then, click on Map columns for import button to proceed to mapping window.

Finally, click on the Import coupons button. The list of coupons imported successfully will be shown as below:

Now, head on to the coupons tab. The imported coupons added in your store can be viewed as shown below:

Related articles:

  1. Bulk Generate Coupons
  2. Setup store credit
  3. Limited Time Coupon Discount
  • Was this article helpful?
  • Yes, thanks!Not really
Get the plugin

On this page

  • Get started
  • Accepting coupon data
  • Importing process

This article posted in Documentation, Import Coupons, Smart Coupons for WooCommerce

Written by

Shesna

Shesna is a technical content writer for WebToffee. She is familiar in working closely with the SMEs to break down complex technical information into a concise, easy to understand manner.

Comments (6)

  1. Guillaume Plouin

    Guillaume Plouin

    June 9, 2022

    How is it possible to set-up free shipping included for a coupon in the csv ?

    Reply
    • Shesna

      Shesna

      June 10, 2022

      Hi Guillaume,

      Thanks for reaching out. You may create a new column header named free_shipping in your CSV. By entering ‘yes’ to respective coupons, you can enable free shipping for those coupons only. Kindly leave the cells blank if you do not want to allow free shipping.

      Reply
  2. Mel Atkins

    Mel

    January 10, 2022

    Have just exported 50 voucher codes with an expiry date as 30 August 2022 and then imported them and the have all changed to 1970-01-01 ??????????????

    Reply
    • Massimo De Alessandri

      Massimo De Alessandri

      May 4, 2022

      I had the same issue. What happened?

      Reply
      • Shesna

        Shesna

        May 6, 2022

        Hi,
        Sorry to know that you are experiencing this way. Please feel free to get in touch with our support team for direct assistance.

        Reply
    • Sylvain Vanderhaegen

      Sylvain Vanderhaegen

      August 22, 2022

      I have the same issue. Date fields for start and expiry are all reset to 1/1/1970

      Reply

Got any query? Please leave a comment or reach out to our support

Cancel reply

Your email address will not be published. Required fields are marked *

We develop awesome WordPress plugins & WooCommerce extensions to help build successful online businesses.

© 2023 WebToffee. All rights reserved.

Our plugins

  • GDPR Cookie Consent
  • PDF Invoices & Packings Slips
  • Product Import Export Plugin
  • User & Customer Import Export
  • Import Export Suite
  • Sequential Order Numbers
  • Smart Coupons for WooCommerce
  • URL Coupons for WooCommerce
  • PayPal Express Checkout
  • Stripe Payment Gateway
  • Subscriptions for Woocommerce
  • Product Catalog Sync for Facebook
  • PrintNode for PDF Invoices
  • Order, coupon, subscriptions for WooCommerce
  • WordPress Backup and Migration
View more +

Get Started

  • Plugins
  • Testimonials
  • Affiliates
  • We're hiring

Help & Support

  • Documentation
  • Documentation (Basic)
  • FAQ
  • Support

Company

  • Terms & Conditions
  • Privacy Policy
  • Refund policy
  • Support policy
  • License Activation

© 2023 WebToffee. All rights reserved.

We use cookies on our website to give you the most relevant experience by remembering your preferences and repeat visits. By clicking “Accept”, you consent to the use of ALL the cookies. However you may visit Cookie Settings to provide a controlled consent.
Cookie settingsACCEPT
Privacy & Cookies Policy

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these cookies, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of the basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website, to store user preferences and provide you with content and advertisements that are relevant. Such cookies will be stored on your browser but only upon procuring consent.

You will also have the option to opt-out of these cookies should you want to. But opting out of some of these cookies may have an effect on your browsing experience as per the descriptions elucidated against the respective categories below.

Necessary
Always Enabled
The cookies defined under this category are absolutely essential for the website to function. Hence they are loaded by default irrespective if user consent.
CookieDescription
__cfruidCloudflare sets this cookie to identify trusted web traffic.
__stripe_midStripe sets this cookie cookie to process payments.
__stripe_sidStripe sets this cookie cookie to process payments.
cookielawinfo-checkbox-advertisementSet by the GDPR Cookie Consent plugin, this cookie is used to record the user consent for the cookies in the "Advertisement" category .
cookielawinfo-checkbox-analyticsSet by the GDPR Cookie Consent plugin, this cookie is used to record the user consent for the cookies in the "Analytics" category .
cookielawinfo-checkbox-necessarySet by the GDPR Cookie Consent plugin, this cookie is used to record the user consent for the cookies in the "Necessary" category .
cookielawinfo-checkbox-preferencesThis cookie is set by the GDPR Cookie Consent plugin to check if the user has given consent to use cookies under the "Preferences" category.
CookieLawInfoConsentRecords the default button state of the corresponding category & the status of CCPA. It works only in coordination with the primary cookie.
PHPSESSIDThis cookie is native to PHP applications. The cookie is used to store and identify a users' unique session ID for the purpose of managing user sessions on the website. The cookie is a session cookie and is deleted when all the browser windows are closed.
viewed_cookie_policyThe cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not a user has consented to the use of cookies. It does not store any personal data.
Analytics
Analytics cookies help us understand how our visitors interact with the website. It helps us understand the number of visitors, where the visitors are coming from, and the pages they navigate. The cookies collect this data and are reported anonymously.
CookieDescription
_gaThis cookie is installed by Google Analytics. The cookie is used to calculate visitor, session, campaign data and keep track of site usage for the site's analytics report. The cookies store information anonymously and assigns a randomly generated number to identify unique visitors.
_ga_BQH8MSKD4MThis cookie is installed by Google Analytics.
_gat_gtagIdentification code of website for tracking visits.
_gidThis cookie is installed by Google Analytics. The cookie is used to store information on how visitors use a website and helps in creating an analytics report of how the website is doing. The data collected including the number visitors, the source where they have come from, and the pages visited in an anonymous form.
_hjAbsoluteSessionInProgressHotjar sets this cookie to detect the first pageview session of a user. This is a True/False flag set by the cookie.
_hjFirstSeenHotjar sets this cookie to identify a new user’s first session. It stores a true/false value, indicating whether it was the first time Hotjar saw this user.
_hjidHotjar cookie. This cookie is set when the customer first lands on a page with the Hotjar script. It is used to persist the random user ID, unique to that site on the browser. This ensures that behavior in subsequent visits to the same site will be attributed to the same user ID.
_hjIncludedInPageviewSampleHotjar sets this cookie to know whether a user is included in the data sampling defined by the site's pageview limit.
_hjIncludedInSampleThis cookie is set to let Hotjar know whether that visitor is included in the sample which is used to generate heatmaps, funnels, recordings, etc.
_hjIncludedInSessionSampleHotjar sets this cookie to know whether a user is included in the data sampling defined by the site's daily session limit.
_hjTLDTestTo determine the most generic cookie path that has to be used instead of the page hostname, Hotjar sets the _hjTLDTest cookie to store different URL substring alternatives until it fails.
CONSENTYouTube sets this cookie via embedded youtube-videos and registers anonymous statistical data.
has_recent_activityThis cookie is used to signal to the code repository website if the user has browsed other website resources during the current session.
tk_aiGathers information for our own first-party analytics tool about how our services are used. A collection of internal metrics for user activity and is used to improve user experience.
tk_lrThis cookie is set by the JetPack plugin on sites using WooCommerce. This is a referral cookie used for analyzing referrer behavior for Jetpack.
tk_orThis cookie is set by the JetPack plugin on sites using WooCommerce. This is a referral cookie used for analyzing referrer behavior for Jetpack.
tk_qsGathers information for our own first-party analytics tool about how our services are used. A collection of internal metrics for user activity and is used to improve user experience.
tk_r3dThe cookie is installed by JetPack. Used for the internal metrics for user activities to improve user experience.
Advertisement
Advertisement cookies help us provide our visitors with relevant ads and marketing campaigns.
CookieDescription
_fbpThis cookie is set by Facebook to deliver advertisements when they are on Facebook or on a digital platform powered by Facebook advertising after visiting this website.
frThe cookie is set by Facebook to show relevant advertisements to the users and measure and improve the advertisements. The cookie also tracks the behavior of the user across the web on sites that have Facebook Pixel or Facebook social plugin.
VISITOR_INFO1_LIVEA cookie set by YouTube to measure bandwidth that determines whether the user gets the new or old player interface.
YSCYSC cookie is set by Youtube and is used to track the views of embedded videos on Youtube pages.
yt-remote-connected-devicesYouTube sets this cookie to store the video preferences of the user using embedded YouTube video.
yt-remote-device-idYouTube sets this cookie to store the video preferences of the user using embedded YouTube video.
Preferences
Preference cookies are used to store user preferences to provide them with content that is customized accordingly. This includes the language of the website or the location of the visitor.
CookieDescription
_gh_sessThis cookie is used to preserve users' states across page requests.
Others
Other uncategorized cookies are those that are being analyzed and have not been classified into a category as yet.
CookieDurationDescription
_hjSession_137657130 minutesNo description
_hjSessionUser_13765711 yearNo description
_octo1 yearNo description available.
_zendesk_authenticatedpastNo description
_zendesk_sessionsessionNo description available.
_zendesk_shared_sessionsessionNo description available.
edd_wp_session12 hoursNo description available.
logged_in1 yearNo description available.
m2 yearsNo description available.
Save & Accept