🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Advanced Coupons & Discounts Premium Add-on Setup Guide

Updated 8 min read Gravity Forms Payments & Pricing
On this page
  1. Video walkthrough
  2. Step 1: Install and Activate Your License
  3. Step 2: Create a Coupon
  4. Step 3: Choose the Discount and What It Applies To
  5. Step 4: Add Conditions, Limits and Single-Use Codes
  6. Conditions
  7. Usage limits
  8. Single-use codes
  9. Step 5: Add the Coupon Code Field to Your Form
  10. How Discounts Are Calculated and Recorded
  11. Limits and What Is Not Included in Version 1.0
  12. Developer Example
  13. Troubleshooting & FAQ
  14. A valid code says it doesn’t apply.
  15. The code works once and then says it has been used.
  16. Customers see “Too many attempts. Please wait a few minutes”.
  17. The coupon usage stays “pending”.
  18. Can a customer use more than one code?
  19. Resource Hub

Video walkthrough

Gravity Forms Coupons for One Product, Only When Conditions Match
Video walkthrough: per-product, conditional coupon codes with a live total in Gravity Forms. Watch on YouTube

The coupons built into Gravity Forms take a flat amount or a percentage off the whole form. The Gravity Forms Advanced Coupons & Discounts Premium Add-on lets you discount exactly the products you choose, only when the customer’s answers match your rules, with buy X get Y offers, automatic discounts, usage limits and batches of single-use codes. Discounts are recalculated on the server, so the amount charged always matches the total the customer sees.

This guide covers installation, the add-on settings, creating coupons, adding the Coupon Code field to a form, how discounts and free orders are handled, the limits of version 1.0 and troubleshooting.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.7 or higher. Gravity Forms 3.x is recommended; on 2.7 to 2.9, test your product forms on a staging site first.
  • Product fields: A form with Product fields (and optionally Shipping and Total fields)
  • Official Coupons Add-On: Not required
  • GravityExtra license: The add-on installed, activated and licensed with an active GravityExtra license key

Step 1: Install and Activate Your License

  1. In WordPress go to Plugins → Add New → Upload Plugin, upload the add-on ZIP file and click Activate.
  2. Go to Forms → Settings → Coupons and activate your license key in the Gravity Extra License section.
  3. Once the license is active, the Free orders and protection section appears on the same page and the coupon manager opens under Forms → Coupons.

The Free orders and protection section has three settings:

  • Fully discounted orders (on by default): when a discount brings the total to zero on a form with an active payment feed, no payment is taken and the entry is marked Paid with amount 0 and payment method “Coupon”.
  • Payment fields on free orders (on by default): hides credit card fields while the order total is zero.
  • Invalid code attempts (default 20): the number of invalid codes a visitor can try in 10 minutes before being asked to wait. This slows down anyone guessing codes.

Step 2: Create a Coupon

Go to Forms → Coupons and click Add coupon. The list shows every coupon with its code, discount, what it applies to, how many times it has been used against its limit, and whether it is active or automatic.

Coupons list in Forms, Coupons with name, code, discount, applies to, used and limit, status and edit and delete buttons
Forms → Coupons: whole-order, per-product, automatic and single-use coupons in one list.

The Coupon section of the edit screen has:

  • Name: shown to customers on the order summary line, for example “Early bird discount”.
  • Code: letters, numbers, dashes and underscores, not case-sensitive. Leave it empty for automatic or single-use-only coupons.
  • Status: tick Active to allow the coupon to be used.
  • Apply automatically: applies the discount without a code whenever all conditions match.
  • Combining: tick Can’t be combined with other coupons to stop stacking.

Step 3: Choose the Discount and What It Applies To

In the Discount section pick a Discount type:

Discount type What it does
Percentage off Takes a percentage off the whole order or off the selected products.
Fixed amount off Takes an amount off the order. On selected products, it takes the amount off each item.
Fixed price per item The selected items cost the amount you enter, for example a Large hoodie for $15.
Free product Makes a number of the selected items free (Free items); the cheapest ones are discounted first.
Buy X, get Y For every Buy (X) items, the next Get (Y) items get Discount on Y (%) off. 100 makes them free; the cheapest items are discounted.

Under Applies to, choose Whole order (all products, shipping excluded) or Selected products or choices. The product list is grouped by form. Tick a product to include any of its choices, or tick a single choice such as “Hoodie: Large”.

Coupon edit screen with Discount type Percentage off, Amount 15 and Applies to Selected products or choices with the T-shirt product ticked
A 15% discount that applies only to the T-shirt product.

Step 4: Add Conditions, Limits and Single-Use Codes

Conditions

  • Forms: tick the forms the coupon works on. Leave all unchecked to allow every form.
  • Minimum subtotal and Maximum subtotal: based on the product subtotal before discounts, shipping excluded.
  • Starts on and Ends on: dates use the site time zone and include the whole day.
  • Field rules: Apply when all/any of these rules match, with the operators is, is not, greater than, less than, contains, starts with and ends with. For example, “Registration type is Student”. Rules use the values the customer has entered, and a rule only applies on the form its field belongs to.

Usage limits

Total uses caps how many times the coupon can be used, and Uses per email address caps it per customer using the first Email field of the form. Leave either empty for unlimited. Uses are counted only after a successful submission or payment, so an abandoned or declined payment never uses up a code.

Single-use codes

Save the coupon first. The Single-use codes panel then lets you generate codes in batches: set How many (up to 5,000 per click), an optional Prefix such as VIP- and the Length, then click Generate codes. Each code works once and uses this coupon’s discount and conditions. The panel shows how many are available and used, and Export codes (CSV) downloads them for your email tool.

Step 5: Add the Coupon Code Field to Your Form

Open the product form in the form editor and add Coupon Code from the Pricing Fields group. You can change its label, description and placeholder, and use conditional logic and visibility as with other fields. Automatic coupons apply without a code, so a Coupon Code field is only needed when customers type codes.

Customers type a code and click Apply. The discount appears below the field with a Remove link, and the Total updates straight away. Clear messages explain why a code cannot be used, for example “This code has expired.” or “This code needs an order subtotal of at least $50.00.”

Product form with a Coupon code field, the SAVE10 code applied as a minus 4 dollar discount line with a Remove link and the updated total of 41 dollars
Two T-shirts at $20, $5 shipping and the SAVE10 code: 10% off the products, total $41.

Pre-apply a code from a link

In the field’s Advanced tab, tick Allow field to be populated dynamically and enter a parameter name such as coupon. A link like https://example.com/register/?coupon=EARLYBIRD then fills in the code for the customer, which works well in email campaigns.

How Discounts Are Calculated and Recorded

  • Server-side totals: the browser asks your site for the discount, but the final discount is calculated again on the server when the form is submitted. A total changed in the browser is ignored.
  • Clear order lines: each discount is a negative line such as “Save 10% (SAVE10)” in the order summary, notifications and entry, and payment add-ons receive it as a discount.
  • Entry box: entries with a discount show a Coupons & Discounts box with the codes, amounts, whether usage has been recorded and whether the order was free.
  • Usage counting: usage is recorded after a successful submission, or after the payment status is Paid, Active or Authorized. For gateways that complete the payment later, the entry shows “Usage will be recorded when the payment completes” until Gravity Forms reports the payment as completed.
  • Free orders: when discounts bring the total to zero, Gravity Forms does not send the order to the payment gateway. Required card fields are not required, are hidden (if that setting is on), and the entry gets a note that no payment was required.

Test free orders and redirect gateways on your site first

Before you announce a 100% code, place a fully discounted test order with your payment gateway in test or sandbox mode. Do the same for PayPal Checkout or any gateway that sends customers to another page to pay, and check that the coupon usage is recorded once the payment completes. Each gateway handles its own payment screen, so confirm the flow on your own site before going live.

Limits and What Is Not Included in Version 1.0

  • Tiered or quantity-break pricing tables, cart-level “spend X get Y” offers, gift cards and store credit.
  • Discounts aimed specifically at shipping, setup fees, trial amounts or subscription renewal amounts. A subscription feed that uses the Form Total receives the discounted total.
  • Products inside Repeater fields; discounts only see top-level product fields.
  • User role conditions, applying a discount from a URL without a Coupon Code field, usage reports and charts, coupon import, and migrating coupons from the official Coupons Add-On.
  • With gateways that confirm the payment later, two customers paying at the same moment could both use the last remaining use of a code.

If the official Gravity Forms Coupons Add-On is also active, Forms → Coupons shows a notice. Use only one coupon field per form for clear totals, and test any form that uses both on a staging site first.

Developer Example

The applied discounts are saved with the entry in the gfx_advancedcoupons_applied entry meta (coupon ID, code, name and amount). This example uses the Gravity Forms gform_after_submission action, after the add-on has recorded usage, to send the codes to your CRM.

functions.php
PHP
// Send the coupon codes used on an order to your CRM
add_action( 'gform_after_submission', function( $entry, $form ) {
    $applied = gform_get_meta( $entry['id'], 'gfx_advancedcoupons_applied' );
    if ( empty( $applied ) ) {
        return;
    }
    $codes = wp_list_pluck( $applied, 'code' );
    $saved = array_sum( wp_list_pluck( $applied, 'amount' ) );
    wp_remote_post( 'https://crm.example.com/hooks/coupon-used', array(
        'body' => array(
            'entry_id' => $entry['id'],
            'codes'    => implode( ',', array_filter( $codes ) ),
            'saved'    => $saved,
        ),
    ) );
}, 30, 2 );

Troubleshooting & FAQ

A valid code says it doesn’t apply.

Check each condition on the coupon: the form is ticked under Forms (or none are ticked), the dates include today in the site time zone, the product subtotal is within the minimum and maximum, the field rules match the customer’s answers, and for Selected products or choices at least one targeted product is in the order. The message under the field tells the customer which condition failed.

The code works once and then says it has been used.

That is expected for single-use codes and for coupons with Total uses or Uses per email address limits. Check the Used / limit column in Forms → Coupons. A per-email limit needs an Email field on the form, and customers are asked to enter their email before applying the code.

Customers see “Too many attempts. Please wait a few minutes”.

The visitor tried more invalid codes than allowed in 10 minutes. Wait, or raise Invalid code attempts under Forms → Settings → Coupons. Visitors behind one shared office network count together.

The coupon usage stays “pending”.

Usage for gateways that confirm the payment later is recorded when Gravity Forms marks the payment as completed. If the payment was never completed, the usage is not counted, which is intended. Check the entry’s payment status and notes.

Can a customer use more than one code?

Yes, up to 10 codes per order, unless a coupon is set to Can’t be combined with other coupons.

Resource Hub

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr