Fetching contributors…
Cannot retrieve contributors at this time
99 lines (60 sloc) 4.46 KB
id title
Email centre


As of 10.8.0, Preside comes with a sophisticated but simple system for email templating that allows developers and content editors to work together to create a highly tailored system for delivering both marketing and transactional email.

See [[emailtemplating]] for documentation on the basic email templating system prior to 10.8.0


Email layouts

Email "layouts" are provided by developers and designers to provide content administrators with a basic set of styles and layout for their emails. Each template can be given configuration options that allow content administrators to tweak the behaviour of the template globally and per email.

An example layout might include a basic header and footer with configurable social media links and company contact details.

See [[creatingAnEmailLayout]].

Email templates

An email template is the main body of any email and is editorially driven, though developers may provide default content. When creating or configuring an email template, users may choose a layout from the application's provided set of layouts. If only one layout is available, no choice will be given.

Email templates are split into two categories:

  1. System email templates (see [[systemEmailTemplates]])
  2. Editorial email templates (e.g. for newsletters, etc.)

Editorial email templates will work out-of-the-box and require no custom development.

Recipient types

Recipient types are configured to allow the email centre to send intelligently to different types of recipient. Each email template is configured to send to a specific recipient type. The core system provides three types:

  1. Website user
  2. Admin user
  3. Anonymous

You may also have further custom recipient types and you may wish to modify the configuration of these three core types. See [[emailRecipientTypes]] for a full guide.

Service providers

Email service providers are mechanims for performing an email send. You may have a 'Mailgun API' service provider, for example (see our Mailgun Extension).

The core provides a default SMTP provider and you are free to create multiple different providers for different purposes. See [[emailServiceProviders]] for a full guide.

General settings

Navigating to Email centre -> Settings reveals a settings form for general email sending configuration. You may wish to add to this default configuration form, or retrieve settings programmatically. See [[emailSettings]] for a full guide.

Feature switches and permissions


The email centre admin UI can be switched off using the emailCentre feature switch. In your application's Config.cfc file:

settings.features.emailCenter.enabled = false;

Furthermore, there is a separate feature switch to enable/disable custom email template admin UIs, customEmailTemplates:

settings.features.customEmailTemplates.enabled = false;

Both features are enabled by default. The customEmailTemplates feature is only available when the the emailCenter feature is also enabled; disabling just the emailCenter feature has the effect of disabling both features.

As of 10.9.0, the ability to re-send emails sent via the email centre has been added. This is disabled by default, and can be enabled with the emailCenterResend feature:

settings.features.emailCenterResend.enabled = true;

See [[resendingEmail]] for a detailed guide.


The email centre comes with a set of permission keys that can be used to fine tune your administrator roles. The permissions are defined as:

settings.adminPermissions.emailCenter = {
	  layouts          = [ "navigate", "configure" ]
	, customTemplates  = [ "navigate", "view", "add", "edit", "delete", "publish", "savedraft", "configureLayout", "editSendOptions", "send" ]
	, systemTemplates  = [ "navigate", "savedraft", "publish", "configurelayout" ]
	, serviceProviders = [ "manage" ]
	, settings         = [ "navigate", "manage", "resend" ]
	, blueprints       = [ "navigate", "add", "edit", "delete", "read", "configureLayout" ]
	, logs             = [ "view" ]
	, queue            = [ "view", "clear" ]

The default sysadmin and contentadmin user roles have access to all of these permissions except for the emailCenter.queue.view and emailCenter.queue.clear permissions. For a full guide to customizing admin permissions and roles, see [[cmspermissioning]].