PaywallProject Docs
  1. Home
  2. PaywallProject plugin
  3. How to create and share coupons

How to create and share coupons

Coupons let you offer discount codes on your subscription levels. A coupon takes a percentage or a fixed amount off the price. You choose how long the discount lasts on recurring levels: the first payment only, a number of months, or every payment. You can also cap redemptions, set an expiration date, and limit the coupon to certain levels. Subscribers enter the code at checkout, or you send them a link that applies it for them.

Create a coupon

  1. In your WordPress admin, go to PaywallProject → Coupons.
  2. Click Add coupon.
  3. Fill in the fields described below, then click Save coupon.
The Edit coupon screen with the code DOCS-DEMO-WINBACK, 20 percent off, Applies to set to A number of months and Months set to 3, and a cap of 100 redemptions
A coupon that takes 20% off for the first 3 months.

Code

The code subscribers type at checkout, for example SUMMER25. Use letters, numbers, hyphens, or underscores. Codes are saved in uppercase and aren’t case-sensitive, so summer25 works too. Click Generate to create a random 8-character code.

Type and value

  • Percent: takes a percentage off the price. Enter 25 for 25% off. The maximum is 100%.
  • Fixed amount: takes a set amount off the price. Enter 5.00 for $5 off.

Duration

Since PaywallProject 4.0, you choose how long the discount lasts on recurring levels. Pick one option under Applies to:

  • First payment only: the discount comes off the first payment. Renewals are charged at the level’s regular price. This is the default.
  • A number of months: the discount applies to every payment in the first number of months you enter in Months. Enter a number from 1 to 120. After that, renewals go back to the regular price.
  • Every payment: the discount applies to the first payment and to every renewal for as long as the subscription lasts.
The Duration row with Applies to set to A number of months and Months set to 3
Choose A number of months, then enter how many months the discount lasts.
The Duration row with Applies to set to Every payment
Every payment keeps the discount on all renewals.

One-time levels are always discounted once, whatever you choose here.

Limits

  • Max redemptions: the total number of times the coupon can be used across all subscribers. Once it’s reached, the code stops working.
  • Expires: the last day the coupon can be used. It works through the end of that day.

Leave either field blank for no cap or no expiration. These limits control who can redeem the code. They don’t shorten the discount for subscribers who already used it.

Limit to levels

Check one or more levels to restrict the coupon to those levels only. Leave every level unchecked to allow the coupon on all levels.

Show the coupon field on checkout

The coupon field is controlled per level, so you choose which levels accept codes.

  1. Go to PaywallProject → Levels and edit the level.
  2. Scroll to Subscribe form fields.
  3. Set Coupon code to Optional (or Required), then save the level.
The Subscribe form fields section of a level, with Coupon code set to Optional
Set Coupon code to Optional to show the field on this level’s checkout.
  • Hide: no coupon field on this level’s checkout.
  • Optional: subscribers can enter a code if they have one. This is the most common choice.
  • Required: subscribers must enter a valid code to subscribe. Useful for invite-only or partner levels.

What subscribers see

The Coupon code field appears in the Billing step of checkout. When a subscriber enters a valid code, they see a confirmation with how much they saved.

The Billing step of checkout with the coupon DOCS-DEMO-WINBACK entered, a confirmation that says You saved $16.00, and the yearly price shown as $64.00
The coupon is checked as soon as it’s entered.

The order summary shows the discounted amount due today.

The subscription summary showing $28.00 due today with the coupon COMEBACK50 applied
The subscription summary with the coupon applied.

Checkout shows the saving on today’s payment. It doesn’t say how long the discount lasts. If a coupon runs for several months or every payment, say so in the email or post where you share the code.

You can send subscribers a link that opens checkout with the coupon already filled in. This is handy for emails, social posts, and win-back campaigns.

If a coupon is limited to exactly one level, the Subscribe link column on the Coupons page shows a ready-made link. Click Copy link to copy it.

For coupons that apply to several levels, build the link yourself by adding two parameters to your subscribe page URL:

https://yoursite.com/subscribe/?ppaccess_level=yearly&ppaccess_coupon=COMEBACK50
  • ppaccess_level: the slug of the level to check out.
  • ppaccess_coupon: the coupon code.

The coupon field must be set to Optional or Required on that level for the code to be applied.

How discounts are applied

  • Recurring levels: the discount follows the coupon’s Duration. It applies to the first payment only, to the payments in the number of months you set, or to every payment.
  • One-time levels: the discount comes off the purchase price once.
  • Gift subscriptions: coupons work on gift purchases too, using the same level restrictions.

A redemption is counted once the payment succeeds, so abandoned checkouts don’t use up your redemption cap.

Manage your coupons

The Coupons page lists every coupon with its type, value, duration, how many times it’s been redeemed (and the cap, if set), expiration date, and status. The Duration column shows First payment, the number of months (for example 3 months), or Every payment.

The Coupons list with a row for DOCS-DEMO-WINBACK showing percent, 20.00%, Duration 3 months, Redeemed 0/100, and status active
The Duration column shows how long each coupon’s discount lasts.
  • Edit: change a coupon’s discount, duration, limits, expiration, or levels. Your changes apply from the next checkout or plan change. Subscribers who already used the code keep the terms they signed up with.
  • Delete: removes the coupon from the list. The code stops working right away. Subscribers who already used it keep their subscription.

Good to know

  • Coupons you created before PaywallProject 4.0 keep discounting the first payment only. Edit a coupon and change Applies to if you want it to last longer.
  • A number of months counts calendar months from the start of the subscription. On a yearly level, a 3-month coupon discounts only the first yearly payment, because the next one falls after the 3 months.
  • When a subscriber changes plans, their current discount ends unless they enter a coupon code during the change. A code entered during the change replaces the old discount.
  • Choose Every payment with care. A 100% coupon on every payment gives the subscription away for as long as it lasts.

Troubleshooting

“That coupon is not valid.”

The code doesn’t exist, has been deleted, has expired, or has reached its max redemptions. Check the coupon’s row on the Coupons page.

“That coupon does not apply to the selected level.”

The coupon is limited to other levels. Edit the coupon and check this level under Limit to levels, or uncheck all levels to allow it everywhere.

“That coupon is not valid for this currency.”

Fixed-amount coupons are tied to a currency. Use a percent coupon for levels priced in a different currency.

I don’t see the coupon field at checkout

Edit the level and make sure Coupon code under Subscribe form fields is set to Optional or Required.

A renewal was charged at the full price

Check the duration that applied when this subscriber redeemed the code. A coupon set to First payment discounts only the first payment, and a coupon set to a number of months stops after those months.

The Duration column on the Coupons page shows the coupon’s settings today. If you edited the duration or discount after this subscriber signed up, the column no longer matches what they got. They keep the terms that applied when they used the code. To see those terms, open the subscriber’s subscription in your Stripe dashboard and look at its discount.

Updated on October 28, 2026
Was this article helpful?

Related Articles

Get more help
Can't find the answer you're looking for? Get in touch.
Contact support