Skip to content
Gaurav TiwariDocs

Manage Subscriptions in the Admin

Version 1.0.0-beta.1 Updated November 8, 2026

Sooner or later a subscriber asks you to move their billing date, fix an address or cancel on their behalf. If that means digging through order meta or a database row, you’ll put it off, and the subscriber waits.

The Subscriptions module gives you a list screen, a full edit screen, thirteen emails and a dashboard widget for recurring revenue. The screens live under Stackless → Subscriptions and need the edit_shop_payments capability.

The Subscriptions List

The list has an All view plus a view for each status that has subscriptions: Pending, Trial, Active, On hold, Paused, Pending cancellation, Cancelled and Expired, each with a count. The search box matches the subscription ID, email, customer name or item name.

Columns:

  • Subscription, with the customer name and email
  • Status
  • Items
  • Recurring total, with the payment method
  • Start date, Next payment and End date (“When cancelled” for plans that renew until cancelled)
  • Renewal: Automatic, Manual, or Gateway when Polar, Paddle, Dodo Payments, Creem or Stripe Managed Payments bills it

Subscription, Start date and Next payment are sortable. Bulk actions: Cancel at period end, Cancel now, Put on hold and Reactivate.

Stackless → Subscriptions list in Stackless for EDD showing subscriptions with Active, Pending cancellation and On hold statuses, recurring totals, dates and the Renewal column

Edit a Subscription

Click a subscription to open its edit screen. The Details box lets you change:

  • Customer (user ID), with links to the WordPress user and the EDD customer, and Email.
  • Status: a status change runs the same steps as the matching action, so schedules and gateways follow.
  • Billing schedule: Every 1 to 365 days, weeks, months or years.
  • Renewal: Automatic or Manual (invoice). On a gateway that bills subscriptions itself, it’s set at checkout and can’t be changed here.
  • Payment method and Token ID: the gateway and the saved payment method ID it charges.
  • Trial end, Next payment and End: dates in your site’s timezone. Start and Last payment are read-only.

Periods shows how many billing periods are paid, like “3 of 12 paid” or “1 paid, renews until cancelled”. Currency and Parent order sit below it. A paused subscription also shows Paused, with since when and when it resumes, and a subscription the customer cancelled with the form shows Cancellation reason, with their comment.

Subscription edit screen in Stackless for EDD with the Details box, Actions dropdown, Save subscription button, Scheduled actions and Notes

Below Details:

  • Recurring items: edit each item’s quantity and line total (excl. tax). Tick Recalculate taxes from the address after saving item changes when taxes should follow the address. Any switch amount carried to the next renewal shows here.
  • Billing address: name, address lines, city, state or region, postal code and country code.
  • Related orders: the parent, renewal, early renewal and switch orders.

The side column has three boxes:

  • Actions: Process renewal now, Retry failed payment, Email renewal invoice, Email renewal reminder, Put on hold, Pause until resumed, Resume (paused), Skip next renewal, Reactivate, Cancel at period end and Cancel now. Pick one, then click Save subscription.
  • Scheduled actions: the next renewal, trial end, end of term, payment retry, overdue check, renewal reminder and trial reminder.
  • Notes: the subscription’s history, plus a box to add a private note.

EDD’s order details screen gets a Subscriptions panel too. It lists each linked subscription and whether the order created, renewed or switched it.

Date and Action Rules

  • The next payment date must be in the future and before the end date.
  • Changing the next payment date also moves the billing day for later renewals.
  • For Polar, Paddle, Dodo Payments, Creem and Stripe Managed Payments subscriptions, the next payment date can’t be changed, and schedule changes here don’t change the provider’s billing.
  • Retry failed payment only works on an on-hold subscription with an unpaid renewal.
  • Email renewal invoice needs an unpaid renewal order to send.

Pause, Resume and Skip

To pause a subscription, pick Pause until resumed in Actions, or set Status to Paused, and click Save subscription. It stays paused until you or the customer resume it: pick Resume (paused) in Actions, or set Status back to Active.

A pause from here follows the same rules as a customer pause, whether or not Customer pause is on for customers. Only an Active subscription with nothing unpaid can be paused, and not one billed by Polar, Dodo Payments or Creem. The paid time left is given back on resume, and the customer gets the Subscription paused and Subscription resumed emails.

Put on hold and Paused aren’t the same. On hold keeps the dates as they are and waits for a payment or for you. Paused gives back the paid time left when it resumes and moves a fixed-length plan’s end date.

Skip next renewal moves the next payment one billing period later without charging it, like the customer’s button, whether or not Skip a renewal is on for customers. Both are covered in Let Customers Manage Subscriptions.

The Thirteen Subscription Emails

All thirteen are on Stackless → Emails, where you can turn each one on or off and change its subject and heading. Admin emails also take a list of recipients, and empty uses the admin notification emails from Downloads → Settings → Emails. Every email is on by default.

EmailSent toWhen
New subscription (admin)StoreA subscription starts.
New subscriptionCustomerTheir subscription starts.
Subscription renewal invoiceCustomerA manual renewal is due, with a link to pay. Also used for unpaid-renewal reminders.
Subscription renewedCustomerA renewal payment succeeds.
Subscription payment failedCustomerA renewal payment fails, with a link to pay.
Upcoming renewal reminderCustomerA few days before each renewal.
Free trial endingCustomerA few days before a free trial ends.
Subscription cancelledCustomerA subscription is cancelled or set to end at the close of the paid period.
Subscription expiredCustomerA fixed-length subscription reaches its end.
Subscription switchedCustomerThe customer switches to another plan.
Card expiringCustomerBefore a renewal, when the saved card it will charge expires first. The timing is the Card-expiring email setting.
Subscription pausedCustomerA subscription is paused, by the customer or the store.
Subscription resumedCustomerA paused subscription resumes.

Subjects and headings can use {site_title}, {subscription_number}, {order_number} and {next_payment_date}. Each email is wrapped in EDD’s own email template, so it matches your receipts.

To change an email’s body, copy it from templates/subscriptions/emails/ in the plugin to stackless-edd/subscriptions/emails/ in your theme. See Emails for the rest of the email settings.

The Dashboard Widget

The Subscriptions widget on the WordPress dashboard shows:

  • Active: subscriptions that are active, in trial or pending cancellation
  • Churn (30 days): subscriptions cancelled or expired in the last 30 days, divided by those plus the ones still active
  • Renewals in 7 days
  • Monthly recurring revenue, one line per currency, with each plan converted to a monthly amount
  • trial, on-hold and paused counts, up to 10 upcoming renewals with links, and View all subscriptions

Trials, on-hold and paused subscriptions aren’t counted in MRR. The numbers are cached for up to an hour and refresh when a subscription changes status or a renewal is paid.

Stackless for EDD Subscriptions dashboard widget with 9 active, 10.0% churn over 30 days, 0 renewals in 7 days and $92.33 USD monthly recurring revenue

Coexisting with EDD Recurring Payments

Stackless pauses its Subscriptions module while EDD Recurring Payments is active, so the two never process the same renewals. Its card on Stackless → Dashboard shows “Paused because EDD Recurring Payments is active and does the same job.”

The EDD Recurring Migration module changes that. While it’s on, or once it has imported subscriptions, Stackless Subscriptions runs beside EDD Recurring: EDD Recurring renews what you left on it and Stackless renews what moved. See Migrate from EDD Recurring Payments.

Limits

  • The importer brings subscriptions over from EDD Recurring Payments only. See Migrate from EDD Recurring Payments.
  • Cancellation reasons show on the subscription and in Billing Health. WordPress’s personal data export includes the reason and the customer’s comment, and erasing the customer’s personal data removes the comment, from its notes too, and keeps the reason.
  • MRR is reported per currency and isn’t converted into one total.
  • Changing the billing schedule here doesn’t change what Polar, Paddle, Dodo Payments, Creem or Stripe Managed Payments bill. Change it at the provider.
  • For renewal timing and retries, see Handle Renewals and Failed Payments. For stuck and failed renewals across the store, see Find Billing Problems with Billing Health.
Share

Was this helpful?

Still stuck? Open a support ticket