Skip to content

Configuring Email Notifications ​

The Notifications section in FluentCart is where you manage all the automated transactional emails sent to both your customers and store administrators. Keeping everyone informed about order activity is crucial for a professional e-commerce experience and efficient store management.

This guide will walk you through how to enable, disable, and customize these important email notifications.


Accessing the Notifications Screen ​

  1. From your WordPress dashboard, navigate to FluentCart Pro > Settings.
  2. Click on the Email Configuration tab.
  3. From the sub-menu, select Notifications.

Managing Your Notifications ​

On this screen, you will see a list of all available email notifications. For each one, you can see its Notification Name, the intended Recipient (Admin or Customer), and a toggle to enable or disable it.

Available Notifications: ​

The notifications are grouped below by what they cover. On screen, FluentCart lists them under the groups Order Actions, Subscription Actions, Store-Managed Renewals, Store-Managed Renewals · Auto-Charge, Scheduler / Reminder Actions, and Review Actions. Notifications added by add-ons without a group of their own appear under Other Actions.

Orders and refunds

  • Send mail to admin after New Order Paid: Notifies the store admin when a new order has been successfully paid for.
  • Purchase receipt to customer: Sends a receipt to the customer immediately after their order is placed.
  • Send mail to admin after New Order Placed (Offline Payment): Alerts the admin when an order arrives through an offline payment method.
  • Order confirmation to customer (Offline Payment): Confirms an offline-payment order to the customer.
  • Send mail to admin after a refund: Informs the admin that a full or partial refund has been processed. This one is off by default.
  • Send mail to customer after a refund: Notifies the customer that a refund has been issued for their order.

Shipping

  • Send mail to customer when a shipment is created: Sends the customer the tracking details of one shipment when you create it with Notify Customer selected. It has no toggle in the list. Instead it reads "Sent when "Notify customer" is ticked", because the checkbox on each shipment decides whether it goes out. See The Shipment Email below.
  • Send mail to customer when shipping status changed to shipped: Informs the customer that their physical order has been shipped. It is not sent while a shipment is being created, because the shipment email already covers that news.
  • Send mail to customer when shipping status changed to delivered: Confirms to the customer that their order has been marked as delivered.

Subscription renewals

  • Send mail to customer after a subscription renewed: Confirms to the customer that their subscription renewal payment was successful.
  • Send mail to admin after a subscription renewed: Alerts the admin that a subscription renewal payment has been made.
  • Send the renewal order to the customer when a renewal order is created: Delivers the renewal order to the customer when FluentCart generates one for a store-billed subscription. This is the email carrying the Pay Now link.
  • Notify admin when a renewal order is created: The admin-side copy of the same event.
  • Notify customer when an automatic renewal charge fails and Notify admin when an automatic renewal charge fails (in the Subscription Actions group): Sent when Stripe or PayPal reports a failed renewal charge on a gateway-billed subscription. The customer email is on by default. The admin copy is off by default.

Automatic renewal charges

These sit in the Store-Managed Renewals · Auto-Charge group and apply to store-billed subscriptions, when your store charges saved payment methods automatically. See Store Billing for Subscriptions for how that mode works. Two of them share their names with the gateway-billed pair above, so check the group when you edit one.

  • Notify customer before an automatic renewal charge: Tells the customer the amount and date of the upcoming automatic charge to their saved payment method, sent when the renewal order is created ahead of the due date.
  • Notify customer when an automatic renewal charge fails: Sent when the saved payment method could not be charged. It includes the failure reason and a Pay Now link so the customer can settle it manually.
  • Notify admin when an automatic renewal charge fails: The admin-side copy of the failed charge notice. This one is off by default.

Reminders and overdue notices

  • Renewal due reminder to customer: Sent before or on the renewal due date while payment is still pending.
  • Renewal due reminder copy to admin: The admin-side copy of the due reminder. This one is off by default.
  • Payment reminder to customer: A general reminder about a pending payment.
  • First overdue renewal reminder to customer: Sent on the earliest overdue day you configured, once a renewal due date has passed with payment still pending.
  • Follow-up overdue renewal reminder to customer: Sent on the overdue days between the first and the last.
  • Final overdue renewal notice to customer: Sent on the last overdue day you configured while payment is still pending.
  • Upcoming renewal reminder to customer: Sent ahead of a subscription's auto-renewal date.
  • Upcoming renewal reminder copy to admin: The admin-side copy of the upcoming renewal reminder. This one is off by default.
  • Trial ending soon reminder to customer: Sent before a trial period ends and converts to a paid subscription.
  • Trial ending soon reminder copy to admin: The admin-side copy of the trial ending reminder. This one is off by default.
  • Notify customer when subscription is past due: Sent when a subscription is marked past due.
  • Notify admin when a subscription is past due: The admin-side copy of the past due notice. This one is off by default.

Reminder timing is configured separately. The Scheduler / Reminder Actions group shows the note "This notification trigger is controlled from the Reminders section", because when these emails go out is managed in Reminders, not on this screen.

Subscription changes

  • Send mail to customer when a subscription is canceled: Notifies the customer that their subscription has been cancelled and includes the access end date so they know exactly when their access ends. This is especially important for stores running courses, memberships, or licensed products where billing and access are tied together.
  • Send mail to admin when a subscription is canceled: The admin-side copy of the cancellation notice.
  • Notify customer when a billing period is skipped: Sent when an admin skips the customer's next billing period. The internal reason and the name of the admin who skipped it are never included. This one is off by default.

NOTE

The cancellation email is sent automatically whenever a subscription moves to a cancelled state. The access end date is pulled from the subscription's paid-through period, so customers can see at a glance whether their access ends immediately or continues through the end of the current billing cycle.

Product reviews

These appear in the Review Actions group only while Product Reviews are switched on.

  • Send mail to admin when a new review is submitted: Alerts the admin that a customer has left a review.
  • Send mail to the reviewer when their review is approved: Tells the reviewer that their review is now live.
  • Send mail to the reviewer when the store replies to their review: Lets the reviewer know the store has replied.

Withdrawal

When the FluentCart Customer Rights add-on is active, a Withdrawal group with four more emails for EU withdrawal requests appears: Withdrawal acknowledgment to customer, New withdrawal request to admin, Withdrawal accepted notice to customer, and Withdrawal declined notice to customer.

Enabling or Disabling Notifications ​

To quickly activate or deactivate any notification, simply click the toggle switch in the "Enabled" column. The email will only be sent if the toggle is on.

Customizing an Email Notification ​

To customize the content of a specific email, click the pencil icon on the right-hand side of its row. This will take you to the editor for that specific email template.

  • Enable this email notification! This toggle at the top right serves the same purpose as the one on the main list, allowing you to activate or deactivate the email from within the editor.

Email Subject ​

This field controls the subject line of the email. You can personalize it by clicking the shortcode icon {;} on the right to insert dynamic information, such as the customer's name or the order ID.

Email Body Type ​

You have two options for the email's main content:

  • Default Body: This is the standard, pre-written email content provided by FluentCart. It contains all the essential information for that specific notification and is ready to use out of the box. With it selected, FluentCart shows a live preview of the built-in email filled with sample data.
  • Customized Body: Select this option to take full control over the email's content. This is perfect for matching the email's design and tone to your brand's voice. It requires FluentCart Pro, and shows a crown icon without Pro.

The Default Email Layout ​

Emails that use the Default Body share one layout. The email sits in a white card with rounded corners on a light grey background, and it adapts to phone screens.

  • Header: Your store name, with the Order Date, Order #, and Receipt # stacked on the right.
  • Greeting: When the email opens with a greeting and a message, the greeting is styled as a heading.
  • Order summary: A table with an Item, Qty, and Total header bar. Variants and billing details (such as a subscription's billing interval) appear as small labels under each item.
  • Totals: A light box spanning the full width, with a larger Total and the payment method shown as a badge.
  • Addresses: Billing and shipping addresses line by line, with the name in bold.
  • Subscriptions: The order paid email adds a subscription summary box, and the call-to-action button is larger with an arrow.

The wording of the emails is unchanged.

Order Number and Receipt Number ​

The email header shows two different numbers, and so do the receipt page and the PDF documents:

  • Order #: The order's unique 12-character code, for example A7K2P9X4M1Q8. Every order has one from the moment it is created, and it is the same number customers see on their order pages in the customer portal.
  • Receipt #: The receipt number, made of your Receipt Prefix and a running number, for example INV-1001. It is assigned when the order is paid, so the row is left out of emails for unpaid orders, such as an offline payment that has not been confirmed yet. You set the prefix and starting number in the checkout settings.

In the shortcode list, {{order.uuid}} (Order UUID) gives the order number and {{order.invoice_no}} gives the receipt number. When an order has no receipt number yet, {{order.invoice_no}} shows the order number instead, so a subject line such as "Order #{{order.invoice_no}}" is never left blank. Add your own fallback text after a pipe, as in {{order.invoice_no|Pending}}, to show that text instead, or end it with a bare pipe, {{order.invoice_no|}}, to leave it blank until the order is paid.

Customizing the Email Body ​

Customized Body requires FluentCart Pro. Selecting it opens the drag-and-drop email block editor.

  • Block Editor: Design the email with blocks, shortcodes, and conditional content, and structure it exactly as you want it.
  • Shortcodes: Insert dynamic placeholders for order, customer, and general store details. This allows you to create highly personalized and informative emails.
  • Preview: Click Preview to see the email at Desktop, Tablet, and Mobile widths before you save it.

Attach PDF Template ​

When Fluent PDF is active, the editor also shows an Attach PDF Template field. Choose which PDF template (if any) to attach to this email. The default is No PDF attachment, so an email carries a PDF only after you pick one here.

Package Merge Tags ​

For stores selling physical products, FluentCart exposes the package details of each ordered item as email merge tags. Use these to build custom order confirmations, packing notifications, or warehouse-facing receipts that show shoppers exactly what is shipping — without writing any code.

Place the cursor where the tag should appear, click the shortcode icon {;}, and select the tag from the Package group. The tag resolves per line item at send time.

Merge TagRenders
\{\{item.package_name\}\}The package name assigned to the product (e.g., Gift box, Medium Mailer)
\{\{item.package_type\}\}The package shape - Box, Envelope, or Soft package
\{\{item.dimensions\}\}The package dimensions in L x W x H unit format (e.g., 1 x 1 x 1 in)
\{\{item.product_weight\}\}The product's own weight with its unit (e.g., 5 kg)
\{\{item.shipping_weight\}\}The total shipping weight - product weight plus empty-package weight (e.g., 6 kg)

Default email body already includes package info

If the notification uses the Default Body, package name, dimensions, product weight, and shipping weight are rendered automatically below each item line — no template changes needed. The values match what the customer saw on the product page and at checkout.

Values are captured at checkout

When the order is placed, FluentCart snapshots the package data onto the order item itself. The email renderer reads from that snapshot — never re-querying the live product — so even if you rename a package, change dimensions, or adjust weights months later, every historical email (resends, reprints, subscription renewals) still displays the values that were correct when the customer placed the order.

The Shipment Email ​

The Send mail to customer when a shipment is created notification sends one email per shipment, so a customer whose order ships in three parcels gets three emails, each about its own parcel. It goes out when you create a shipment on an order with Notify Customer selected, and only then. There is no on/off switch for it in the notifications list or the editor, so you decide per shipment. See Managing Shipments for where that checkbox is.

The default subject is "Your shipment is on the way #{{order.invoice_no}} 📦". The default body contains:

  • A greeting and the line "Great news! A shipment from your order is on its way to you 📦."
  • Tracking Details: The Carrier, the Service, and the Tracking Number, plus a Track Shipment button when the shipment has a tracking URL. Each row only appears when the shipment has that value, so a manual shipment without a carrier name has no Carrier row. If the shipment has no carrier, service, or tracking at all, the whole box is left out.
  • Items in this Shipment: Only the items and quantities in this shipment, not the whole order.
  • Shipment Notes: The note you added for the customer, when there is one.
  • The customer's addresses and a View Order button that opens the order in their account.

Shipment Shortcodes ​

With Customized Body, you can place details of the shipment anywhere in the email. Click the shortcode icon {;} and pick from the Shipment group:

ShortcodeRenders
\{\{shipment.carrier_name\}\}The carrier name
\{\{shipment.service_name\}\}The carrier service, such as a Shippo service level
\{\{shipment.tracking_number\}\}The tracking number
\{\{shipment.tracking_url\}\}The tracking URL
\{\{shipment.tracking_link\}\}The tracking number as a clickable link
\{\{shipment.status\}\}The shipment status
\{\{shipment.shipped_at\}\}The date the shipment was sent
\{\{shipment.notes\}\}The note to the customer
\{\{shipment.item_count\}\}The number of items in the shipment
\{\{shipment.items\}\}A table of the items in this shipment
\{\{shipment.id\}\}The shipment ID

These only have values in the shipment email. In other notifications, use {{order.shipments}} to list all of an order's shipments.

Shipment Update Starter Template ​

If you build this email in the block email editor that comes with FluentCart Pro, open Starter Templates and click Browse Templates to pick Shipment Update. It is a ready-made layout built on the shipment shortcodes, with the carrier, a linked tracking number, the tracking URL, the items in this shipment, and the notes when there are any. Like the default body, it hides the Carrier row when the shipment has no carrier name, and hides the tracking box when the shipment has neither a carrier name nor tracking.

Once you are finished editing, click the Update button to save your changes. Your customized email will now be sent whenever its corresponding event is triggered.