This document contains all the information related to subscription upgrade confirmation emails, email customization, and activation.
Overview
“Upgrade Completed” is the email notification sent automatically when a customer successfully upgrades their existing subscription.
This notification confirms the upgrade and provides the updated subscription and payment details so customers clearly understand their new plan and billing status.
The email includes:
- Subscription start date
- Subscription ID
- Payment method
- Product details (title, variation, quantity, and price)
- Subtotal
- Shipping
- Taxes
- Discounts
- Total amount charged
- A link to the My Account page for subscription and payment management
Pre-requisites: Before enabling email notifications, ensure your WordPress site is configured to send emails:
- SMTP plugin required: WordPress doesn’t reliably send emails by default. Install and configure an SMTP plugin like WP Mail SMTP.
- Email service provider: Connect your SMTP plugin to a transactional email service (Brevo, Mailgun, SendGrid, Amazon SES, or your hosting provider’s SMTP).
- Match sender details: Ensure that the From Email and From Name values configured in Sublium Subscriptions email notifications exactly match the sender details set in your SMTP plugin.
- Test your setup: Send a test email from your SMTP plugin to confirm emails are delivering before enabling Sublium notifications.
Without proper email configuration, notifications will fail silently.
For more details, refer to our doc on how to set up WP SMTP.
Access “ Upgrade Completed” Email Notification
Navigate to Sublium Subscriptions ⇒ Settings ⇒ Notifications.
Under the Subscriptions tab, you will find the Upgrade Completed email notification.
Trigger Conditions / When It Is Sent
This email is sent when:
- A customer upgrades their subscription plan
- An admin upgrades the subscription manually
Audience
By default, this email is sent to the customer.
Email Customization
You can customize this notification using two editor types:
- Rich Text
- Visual Editor
A prebuilt Upgrade Completed” template is available in both editors, which you can customize or rebuild as needed.
Guide:For more details, check our documentation on email customization.
Personalization
Sublium Subscriptions offers merge tags to personalize the subject line, preview text, and email content.
Simply copy and paste them where needed.
Here are the merge tags used in the prebuilt template:
- {{subscriber_first_name}} – Subscriber’s first name
- {{site_title}} – Name of your website/store
- {{subscription_start_date}} – Subscription start date
- {{subscription_id}} – Subscription ID
- {{card_update_url}} – URL for the subscriber to update their payment details
- {{admin_email}} – Admin email address for support
Guide: For more details, check our documentation on Merge Tags
How To Activate
To activate the “Upgrade Completed” email, turn ON the toggle next to the notification inside Sublium Subscriptions.
This is how you can manage email notifications when a subscription upgrade is completed.
Troubleshooting
Emails not sending
- Confirm your SMTP plugin is configured and sending test emails successfully
- Check your SMTP plugin’s email logs for failed delivery attempts
- Verify the notification toggle is enabled
- Ensure the customer has a valid email address on their order
Merge tags showing as plain text
- Confirm you copied the full merge tag, including the curly braces, e.g., {{subscriber_first_name}}
- Check for extra spaces inside the merge tag
- Use only merge tags from the official list; custom tags won’t work
Email is going to spam
- Configure SPF, DKIM, and DMARC records for your sending domain
- Avoid spam trigger words in your subject line
- Use a reputable transactional email service
Email looks broken or unstyled
- Use the Visual Editor’s built-in templates for better compatibility
- Test across multiple email clients (Gmail, Outlook, Apple Mail)
- Avoid complex CSS, as email clients have limited style support
