Renewal reminder emails are proactive notices sent to customers a configurable number of days before their next scheduled billing date. They help reduce payment failures by prompting customers to verify their payment method is current.
📌 What This Extension Adds: Core DDLS does not send renewal reminders. Subscriptions Pro adds a configurable pre-renewal notification system with deduplication to prevent multiple sends for the same renewal.
How Renewal Reminders Work #
- A WordPress cron job runs daily and checks for upcoming renewals.
- For each subscription with a renewal date within the configured advance window, a reminder email is queued.
- The email is sent and the send event is recorded in
wp_dmsilm_sp_dunning_logwith typerenewal_reminder. - On subsequent daily checks, the deduplication system skips subscriptions that have already received a reminder for the current billing cycle.
Default Schedule #
The default reminder window is 7 days before renewal, configured via dmsilm_sp_renewal_reminder_days (default: [7]).
Option Key Reference #
Two option keys relate to the renewal reminder schedule:
| Option Key | Default | Notes |
|---|---|---|
dmsilm_sp_renewal_reminder_days | [7] | Canonical key — read by get_reminder_schedule() in code. This is the primary option key used by the reminder cron logic. |
dmsilm_sp_reminder_schedule | [7] | Secondary/alias key — also present in the options table. Both keys refer to the same feature. Present due to an early naming inconsistency in the codebase. renewal_reminder_days takes precedence. |
When configuring reminders, write to dmsilm_sp_renewal_reminder_days. Both keys will be present after the upgrade migrator runs.
Multiple Reminder Days #
You can configure multiple reminder windows — for example, [14, 7, 1] would send reminders 14 days, 7 days, and 1 day before renewal. Each reminder day is treated independently for deduplication (one send per window per billing cycle).
Reminder Email Template #
The renewal reminder uses the renewal-reminder.php email template in templates/emails/. It includes the renewal date, amount due, and a link to the customer’s payment method update page.
Configure renewal reminders at DMSI → Subscriptions Pro → General tab.
—
## Next Steps
- Grace Periods and Suspension — Deep dive into the post-failure grace and suspension flow.
- Pause and Resume Overview — Learn about customer-initiated subscription pausing.
- Win-Back Campaigns Overview — Configure re-engagement campaigns for cancelled subscribers.