Skip to content

Guide

Create coupon codes

Monetization · 6 min read

Coupon codes (also called discount codes or promo codes) give members a discount when they subscribe to one of your subscription plans on the web or in the Android app, including when they sign up for a paid community. You choose the discount, which plans it works on, how many times it can be used, and when it expires. You can share the code or a link that fills it in.

Who can do this: Community owners and admins, and custom roles with Manage plans and coupons. · Where: Web (admin console). Members enter coupons on the web and in the Android app. · Plan: Creating a coupon needs a platform plan that includes Paid memberships. Existing coupons stay editable after a downgrade.

Before you create a coupon

Create a coupon code

  1. Go to Admin → Monetization → Coupons and click Create Coupon.
  2. Enter a Coupon Code, or click Generate for a random 8-character code. Codes use letters, numbers, - and _, are saved in uppercase, and must be 3 to 20 characters long.
  3. Choose a Discount Type: Percentage (%) or Fixed Amount. A fixed amount is in your community's settlement currency, which comes from your Stripe account, and doesn't apply to plans priced in another currency.
  4. Enter the Discount. It must be above 0, decimals are fine (12.5% or 9.99), and a percentage can't be more than 100.
  5. Optional: enter Max Uses (optional). Leave it empty for unlimited uses.
  6. Optional: pick an Expiry Date (optional). The code works through the end of that day, in your community's time zone. Click Clear expiry date to remove it.
  7. Under Applies to, tick the plans the code works on. Leave everything unchecked to let the code apply to every plan.
  8. Keep Active turned on.
  9. Under Discount lasts, choose First payment only, First few months (1 to 36), or Forever (percentage discounts only), then click Create Coupon.

How a coupon discount is applied

Discount lasts decides how many payments get the discount. With First payment only, the default, the member pays the plan's normal price when the subscription renews. With First few months, the normal price starts after those months. With Forever, every payment is discounted. If you change this later, subscriptions that already use the code aren't affected.

A coupon only counts as used when the member's payment succeeds. Typing a code and leaving checkout doesn't use up a redemption.

Each member can use a coupon once. A returning member who enters it again sees You've already used this code. Create a new coupon to give them another discount.

Share a coupon code or link with members

On Coupons, open the row's actions menu:

  • Copy Code copies the code. The copy icon next to the code does the same.
  • Copy Link copies a link that opens checkout with the code already filled in, so members don't have to type it. It's available only while the coupon is Usable.

A coupon link opens the Membership Plans page, with the plan already selected if the coupon works on exactly one. In a paid community, a coupon that isn't limited to Access group plans opens the sign-up page instead, where new members join. If it works on exactly one Community access plan, the sign-up page opens with that plan chosen, even if the plan is hidden. The code stays filled in if the member signs in first or is sent to the page for subscribing again after their subscription ends. It's still checked when the member continues, like a typed code.

Where members enter a coupon code

Members enter a coupon in Have a coupon code? on the web, before they go to the Stripe checkout page:

  • On the Membership Plans page, after they choose a paid plan.
  • When they sign up for a paid community, on the form where they create their account.
  • On the page for subscribing again after a subscription ends: Have a coupon code? is a link above the plans that opens the field. With a coupon link, the field is already open and filled in.

In the Android app, members tap Have a coupon code? to open the Coupon Code field before they go to Stripe checkout. It appears on Choose a plan above the subscribe button when they start a new paid subscription, above the plans on the page for subscribing again, and on the account form when they sign up for a paid community.

If the code can't be used, the member stays on the page and sees why: We couldn't find that code., This code is no longer active., This code has expired., This code has reached its usage limit., This code doesn't apply to the plan you selected., or You've already used this code.

The Stripe checkout page has its own promotion code box. It only accepts promotion codes you create in your own Stripe Dashboard, not codes from Coupons. If a member typed the code there, ask them to go back and enter it in Have a coupon code?.

Where coupon codes can't be used

  • In the iPhone and iPad app. Members can't buy subscriptions there; they subscribe on the web.
  • When a member changes the plan of a subscription they already have. To add a coupon to a running subscription, staff can use Apply a coupon on Subscribers. See Manage subscribers, payments, and refunds.

Coupon codes are also different from the codes members enter under Member Center → Redeem Code. A coupon only gives a discount when a member subscribes to a plan. Redeem codes can't be created in the admin console.

Track how a coupon is used

The top of Coupons shows Total Coupons, Total Redemptions (with the total discount given), Expired, and Exhausted (coupons that reached their maximum uses). Search by code, or filter by status. Each row shows the Code, Discount and how long it lasts, which plans it Applies to, its Usage, when it Expires, and one Status: Usable, Inactive, Expired, Exhausted, or Not in Stripe yet.

To see who used a coupon, open the row's actions menu and click View uses. It lists each Member, their Plan, the Discount, and the Date. The discount amount appears once the first paid invoice is settled, so it's 0 until a trial ends.

Edit, deactivate, or delete a coupon

  • Edit a coupon: open the row's actions menu, click Edit, make your changes, and click Update Coupon.
  • Deactivate a coupon: open the actions menu and click Deactivate. The coupon shows Inactive, and members who enter it see This code is no longer active. Click Activate to reuse it.
  • Delete a coupon: open the actions menu, click Delete, and confirm in Delete Coupon. Deleting can't be undone. A coupon that has been used can't be deleted, because its redemptions would lose their record, so deactivate it instead.

Troubleshooting coupon codes

Symptom: A member sees This code isn't ready to use yet. Please contact the community admin. Why it happens: The coupon hasn't been set up in your Stripe account yet. Its Status shows Not in Stripe yet. Fix: Make sure Stripe is connected, then click Sync with Stripe in the banner at the top of Coupons.

Symptom: A member sees This code doesn't apply to the plan you selected. Why it happens: The plan isn't ticked under Applies to. A fixed-amount coupon also doesn't work on a plan priced in a currency other than your settlement currency. Fix: Edit the coupon and tick the plan, or use a percentage discount for that plan.

Symptom: A member says the discount disappeared at renewal. Why it happens: The coupon's Discount lasts setting ended: First payment only, or the months of First few months have passed. Fix: This is expected. To give a member free access instead, see Manage subscribers, payments, and refunds.

Related articles

Was this guide helpful?

Back to guides

Can't find what you need?

If you're a member of a community, its admins are the right people to ask. If you're building or running one on Mateflow, our team can help.