PrintNowPrintNowDocs

Email Notifications

Create and manage the email templates your storefront sends for order events, account actions, approvals, and other transactional triggers.

The Email Notifications page lets you create and manage the email templates your storefront uses for all transactional communications. Each template is tied to a specific trigger type (e.g., "Order New", "Order Shipped", "Lost Password") and defines the sender, recipients, subject line, and HTML or plain text body. When the trigger event occurs on the storefront, the system sends the corresponding email using the configured Email Account SMTP settings.

Templates support macros -- placeholder codes like (%ORDER_ID%) or (%USER_FIRSTNAME%) -- that are replaced with actual data at send time. The available macros change based on the email type, so each template only shows the macros relevant to its trigger.

View Email Notifications

  1. From your admin, go to Settings > Email Notifications.
  2. The page displays a paginated grid of all configured email templates.

Grid Columns

ColumnDescription
TypeThe trigger type for this email template (e.g., "Order New", "Account Created", "Lost Password"). See the full list of types below.
SubjectThe email subject line. May contain macros that are replaced with actual values when the email is sent.
ToThe recipient email address. May contain macros like (%USER_EMAIL%) to dynamically address the email.
Last UpdatedThe date and time the template was last modified.
ActionMenu with two options: Edit and Delete.

Add Email Template

  1. Click Add Email in the page header.
  2. The editor page opens with a three-panel layout: the email body editor (left, taking 3/4 width), the Email Details panel (top right), and the Email Macros panel (bottom right).
  3. Fill in the Email Details fields and compose the email body.
  4. Click Save in the page header.

Edit Email Template

  1. Click the Action menu on any template row and select Edit.
  2. Update the template fields and body content.
  3. Click Save, or click Cancel to discard changes and return to the list.

Email Body Editor

The body editor occupies the left panel and provides two editing modes:

Tabs: Design View | Code View

TabDescription
Design ViewA Froala rich text editor for composing the email body visually with formatting tools, images, and layout controls.
Code ViewA Monaco code editor for editing the raw HTML source of the email body directly.

A fullscreen toggle button (third tab) expands the editor to fill the browser window for easier editing of complex templates.

Email Details (Right Panel)

FieldDescription
TypesThe trigger event for this email. Select from the dropdown to define when this email is sent. Changing the type updates the available macros in the panel below. See the Email Types table for all options.
FromThe sender email address. Typically your store's email address or a macro.
TOThe primary recipient email address. Use (%USER_EMAIL%) to send to the customer, or enter a fixed address for admin notifications.
CCCarbon copy recipient. Optional.
BCCBlind carbon copy recipient. Optional. Useful for sending a copy to the store admin without the customer seeing it.
SubjectThe email subject line. Supports macros (e.g., Order (%ORDER_ID%) Confirmation).
Text / HTMLRadio buttons to set the email format.
Text -- sends the email as plain text.
HTML -- sends the email as HTML, allowing rich formatting and images.

Email Macros (Right Panel)

The Email Macros panel shows all available placeholder codes for the selected email type. Each macro displays its description and code. Click the copy button next to any macro to copy it to your clipboard, then paste it into the email body or subject line.

Macros are replaced with actual data when the email is sent. For example, (%ORDER_ID%) is replaced with the order number, and (%USER_FIRSTNAME%) is replaced with the customer's first name.

Starter Templates

The templates below are responsive, email-client-tested HTML layouts you can drop straight into a new email notification. They only cover the most common email types, but they share the same table-based structure, so they also work as a foundation for building the remaining types.

Click Copy HTML on a template to copy its full source to your clipboard, or Preview template to open it in a new tab and see how it renders. Previews show the raw macro codes -- those are replaced with real order and customer data when the email is sent.

Use a Starter Template

  1. From your admin, go to Settings > Email Notifications and click Add Email (or Edit an existing template).
  2. In the Email Details panel, set Types to the email type shown on the template card, and set the format to HTML.
  3. Click Copy HTML on the template above.
  4. In the email body editor, switch to the Code View tab, select all existing content, and paste to replace it.
  5. Switch to Design View to confirm the layout rendered, then click Save.

Paste into Code View, not Design View. The Froala rich text editor in Design View strips the conditional comments and <style> block these templates rely on for Outlook and mobile support.

Customize a Starter Template

Each template ships with placeholder content you should replace before going live:

PlaceholderWhat to change
Header logoReplace the https://placehold.co/600x75... image URL with a hosted URL for your own logo, sized to 600px wide. Upload the image to your storefront via your FTP account and use its full public URL — email clients cannot load relative paths.
Product images and linksThe Welcome template includes a featured-products row using https://placehold.co/200 images and # links. Point these at real product thumbnails and product page URLs, or delete the block.
Brand colorsThe templates use #007bff for headings and accents in the <style> block. Change it to your storefront's primary color.
Body copyWording is generic on purpose — edit the headings and paragraphs to match your store's voice.
MacrosThe macros already in each template are listed on its card. Add more from the Email Macros panel — only the macros available for the selected email type will be populated at send time.

Send yourself a test email after saving. Macros are only replaced at send time, so the Design View preview shows the raw macro codes rather than real values.

Email Types

TypeTrigger
Account CreatedSent when a new customer account is created on the storefront.
Order NewSent when a new order is placed.
Order ShippedSent when an order is marked as shipped, including tracking information.
Order Pickup ReadySent when an order is ready for customer pickup.
Lost PasswordSent when a customer requests a password reset. Includes the password reset URL.
Proof ApprovedSent when a proof is approved by a customer or approver.
Proof DeclinedSent when a proof is declined by an approver.
Proof PendingSent when an order is awaiting proof approval.
Order Status ChangedSent when an order's status changes. Includes the previous and current status.
Inventory WarningSent when an inventory item falls below its reorder quantity threshold.
Vendor Order NewSent to a trade vendor when a new purchase order is created for them.
Approval CreatedSent when a new invoice/approval request is created.
Approval DeclinedSent when an invoice/approval is declined.
Approval ChangedSent when an invoice/approval is modified.
Approval ApprovedSent when an invoice/approval is approved.
Download InstructionsSent with instructions for downloading digital products.
Download ReadySent when a downloadable product file is ready for the customer.
New User External ProjectSent when a new user is created via an external project submission.
Existing User External ProjectSent when an existing user receives an external project submission.
Affiliate Order NewSent to an affiliate when an order is placed through their referral link.
Shared EstimatesSent when a customer shares a product estimate with another person.

Delete Email Template

  1. Click the Action menu on any template row and select Delete.
  2. Confirm the deletion in the dialog.

Deleting a template means the storefront will not send an email for that trigger type. If no template exists for a trigger, no email is sent when the event occurs.

Associations

AreaEffect
Order placementThe storefront's checkout process (SpcoApi) triggers the "Order New" email when a customer completes an order. The template's macros are populated with order details, billing/shipping addresses, and line items.
Order shippingWhen an order is shipped, the "Order Shipped" email is triggered with tracking number and shipped items information.
Password resetThe Lost Password page (LostPassword.aspx) triggers the "Lost Password" email with a password reset URL.
Proof approvalsThe customer approvals page (mycustomerapprovals.aspx) triggers "Proof Approved", "Proof Declined", and "Proof Pending" emails during the approval workflow.
Inventory alertsWhen inventory stock falls below the reorder threshold, the "Inventory Warning" email is sent to the configured recipients.
Affiliate notificationsThe affiliate system (AffiliateHelper) triggers the "Affiliate Order New" email when an order comes through an affiliate link.
DownloadsThe upload and download processing system triggers "Download Instructions" and "Download Ready" emails for digital product delivery.
Order status changesThe Order Status configuration can associate email templates with specific status transitions, triggering the "Order Status Changed" email automatically.
SMTP deliveryAll emails are sent through the SMTP server configured in Email Account. If the email account is not configured, no emails will be delivered.
  • Email Account — configure the SMTP server used to deliver these notifications
  • Order Status — link email templates to specific status transitions
  • General Settings — storefront identity and branding used in email content

On this page