E-mail notifications and templates
TitanCart sends two kinds of e-mail: messages to your customers (order confirmation, status changes, shipment, account, returns, gift cards) and notices to you, the store administrator (new order, new review, low stock, a return request, a shipping-rate problem). All of them are controlled from one page, Settings → Notifications, and every one of them renders an editable template there.
Edition note: the page is the same in TitanCart Lite and Pro. The Gift Cards, Returns and System groups appear only in Pro, because the features behind them are Pro features.
1. The three tabs
- Events — what happens in the store, grouped (Orders, Products, Account, Customers, Gift Cards, Returns, Reviews, System). Each event has a switch for the Customer and/or the Administrator. A switch off means that e-mail is never sent.
- Templates — the e-mails themselves: one row per e-mail per receiver, with a subject line and an HTML body full of
{placeholders}. Under each name a small Event: line tells you which switch sends it. - Test Email — sends the order confirmation, the new-order notice or a status e-mail to an address of your choice, built from a sample order. Every template row also has its own Send test button in the editor.
2. Which e-mails exist, and which are on by default
A switch you have never touched follows the default: on for the e-mails every store has always sent, off for the notices that were added later, so an update never starts filling your inbox on its own. You can flip any of them.
| Group | Event | Customer | Administrator |
|---|---|---|---|
| Orders | Order was placed | On — the Order Confirmation (or Order Received while a card payment is only authorised or under review) | On — New Order Notification |
| Order status changed to … (one event per status) | On — also needs the status’s Notify customer flag, see section 4 | Off | |
| Download links are ready | On | — | |
| Shipment sent (with tracking) | On — sent only when you tick the box on a shipment, see section 5 | — | |
| Products | Product is back in stock | On (customers who asked to be told) | — |
| Product low stock alert | — | On | |
| Account | Account was created | On — the welcome e-mail | Off |
| Account was activated | On | Off | |
| Account was deactivated | On | Off | |
| Account details were updated | Off — sent when a customer changes their own details under My Account, never when you edit the account | Off | |
| Customers | Account requires activation | — | Off |
| Gift Cards (Pro) | Gift card delivered | On — to the recipient of a digital card | — |
| Returns (Pro) | Return was requested | On | On — also needs Email admin on new return request under Extensions → RMA |
| Return status changed to Approved / Declined / Completed | On | — | |
| Reviews | New review posted | — | Off |
| System (Pro) | Live shipping rates failed | — | Off — see section 7 |
Note: password-reset e-mails are not on this page. WordPress sends those itself, from Settings → E-mails‘ transport like everything else.
3. Editing a template
Open Templates and click a row. You can change the subject and the body; the body is HTML, and the editor has a Preview tab that fills the placeholders with sample data. Click a placeholder in the list beside the editor to copy it.
Placeholders are written as {name}. The common ones work in every template: {site_name}, {site_url}, {company_name}, {company_email}, {support_email}, {site_logo}, {company_footer}, {accent_color}. The order e-mails add {order_number}, {order_date}, {order_status}, {order_total}, {order_items} (the items table), {order_totals}, {billing_address}, {shipping_address}, {payment_method}, {shipping_method}, {order_url}, {invoice_url} and more; the shipment, return, gift-card and account e-mails have their own sets, all listed in the editor with a one-line description.
- Placeholders marked (HTML) insert a ready-made block — a table, an address, a note card. Place them on their own line.
- A placeholder that is empty for this e-mail (no customer note, no tracking link, no personal message on a gift card) simply disappears, so a template never shows an empty label.
- A placeholder you misspell is left in the e-mail as typed, so you can spot it in a test.
- The status dot on a row is a kill switch: Disabled stops that one e-mail even while its event is on. Use it to silence, say, the administrator copy of one status without touching the customer’s.
- Send test in the editor sends the row as it is now — subject, body and the real From and Reply-To headers — with sample data, to the address you type.
Updates keep your edits. When a TitanCart update improves a template, only rows you have never edited are replaced. A row you changed keeps your version, and the store still adds the blocks a newer template would carry (payment instructions, download links, your note on a return) at the end of your body if your body has no placeholder for them.
4. Order status e-mails
Each order status has its own customer template (Order status changed: Processing, …: Completed, and so on). A status you add yourself under Settings → Order Statuses uses the Order status changed: other statuses template, which prints the status name.
Two switches must agree before a customer gets a status e-mail: the event switch on this page and the status’s own Notify customer flag under Settings → Order Statuses. The administrator copy has only this page’s switch (off by default), and since 0.2.65 it has its own subject line so it is not threaded under the customer’s message in Gmail.
One exception: the first change from Pending to Processing never sends a status e-mail, because the order confirmation goes out at that moment and already says the order is being processed.
5. Shipment e-mails
When you record a shipment under Sales → Fulfillment → Create Shipment, the Tracking card has a checkbox, E-mail the customer about this shipment, ticked by default. With it ticked, saving the shipment sends the Order Shipped e-mail: the items in this shipment with the quantity shipped, the carrier, the tracking number, the ship date and a Track Your Package button for USPS, UPS, FedEx and DHL (a carrier of Other has no tracking page, so the button is left out). Untick the box to record a shipment silently.
Editing a shipment later works the same way: the box is unticked by default, and with it ticked a changed tracking number sends Tracking information updated. Other edits never e-mail.
If an order ships in several parcels, each shipment you tick sends its own e-mail listing only its parcel’s items.
6. Return and gift card e-mails (Pro)
Returns. A customer’s return request sends Return Requested to them and New Return Request to you (to the site-administrator address, and only while Email admin on new return request is on under Extensions → RMA). Approving, declining or completing the return sends the matching e-mail; the note you type when changing the status appears in it as {admin_note}. A cancelled return sends nothing. See Returns and RMA.
Gift cards. A digital gift card e-mails its recipient when it is created active, bought in the store, or re-sent from Growth → Gift Cards: the Gift Card template with the code, the value, the sender’s name, the personal message and the expiry date when there is one. Physical cards never e-mail. See Gift cards.
7. The shipping-rate error notice (Pro)
If you quote live rates from USPS, UPS or FedEx and the carrier rejects a request (wrong credentials, an expired token, an outage), the checkout quietly falls back to your other shipping methods — shoppers are never shown an error. To hear about it, switch on Live shipping rates failed in the System group: you then get at most one e-mail per carrier per hour with the carrier’s own error text and a link to your shipping settings. Every failure, mailed or not, is listed under Settings → System Logs.
8. Department e-mail addresses
Under Settings → General Settings → Company → Department E-mail Addresses you decide which mailbox each kind of e-mail comes from and where replies go:
- Order department — the From address of the order, shipment, return, gift card and subscription e-mails, the store contact printed on invoices, and the fallback for every field below. Blank = the WordPress admin e-mail.
- User department — the From address of the account e-mails (welcome, activated, deactivated, details updated, the activation notice to you).
- Site administrator — where your own notices are delivered (new order, status changes, low stock, reviews, accounts, returns, shipping errors), and the From of the System e-mails. Blank = the WordPress admin e-mail.
- Help/Support department — set, every e-mail to a customer carries it as the Reply-To, so a customer who hits Reply reaches your support inbox, and templates can print it with
{support_email}(the return and account templates do). - Reply-To newsletter — set, every campaign from Growth → Email Campaigns carries it as the Reply-To.
Note: a From address must be a mailbox your mail server is allowed to send as. With SMTP (Settings → E-mails) that normally means an address on the same domain as the SMTP account; some providers accept only the authenticated address itself. Send yourself a test after changing a department address.
9. When an e-mail does not arrive
- Check Spam first. Several e-mails with the same subject arriving in one inbox within minutes (a test order you move through three statuses) often land in Gmail’s Spam folder.
- Is the event on for that receiver, and is the template row Active? Both must be true.
- For a status e-mail: does the status have Notify customer ticked under Settings → Order Statuses? Was it the first Pending → Processing change?
- For a shipment e-mail: was the box ticked when the shipment was saved? On an edit, did the tracking number actually change?
- For an administrator notice: it goes to the Site administrator address if set, else the WordPress admin e-mail — check which inbox that is.
- Still nothing? The transport is under Settings → E-mails; the Test Email tab uses the same transport, so a failing test points at the mail server, not at the templates.