Create new mail

To create a new mail select the "Outbox" node in the Sitecore Content Tree and click on "Create new mail" in the "Tasks" pane.

The "Create a new mail" dialog box will be displayed, offering you to select the mail type.

'

Sitecore supports three mail types:

  • HTML mail
  • Plain text mail
  • URL mail

(Described below).

Select the mail type and click on the "Create" button.

Enter the name of the new mail item and click OK.

The mail will be created as a sub node under the outbox node.

Mail types:

HTML Mail

Emails in HTML format. Mail items of the "HTML mail" type have three fields on "Data" tab as shown in the picture below:

  • Subject - the subject of the message
  • Message - the HTML body of the message. This field can be edited with Sitecore HTML editor, just like any other field of the "html" type. To activate the editor click on the arrow button next to the field name.
  • Alternate text - the plain text body of the message. This field will be used if the recipient's mail client does not support HTML mails

Plain text mail

Email in plain text format. Mail items of this type have two fields on the "Data" tab, as shown in the picture below:

  • Subject - the subject of the message
  • Message - the body of the message

URL mail

The URL mail works by extracting a copy of a web page based on a URL - i.e. it extracts the HTML from the URL, and embeds the images on that web page in the mail. The resulting HTML is sent to the recipients.

 

Important note:

All relative links on the page that is sent as URL mail will be converted to fully qualified links. For example, if you have following links on the front page of your Web Site:

 

<a href="/sitecore/admin/dump.aspx" >Dump</a>

<a href="#bookmark">Bookmark</a>

 

and you send the front page as URL mail, the links will be converted to:

 

<a href="http://<domain>/sitecore/admin/dump.aspx" >Dump</a>

<a href=" http://<domain>#bookmark">Bookmark</a>

 

Mail items of this type have three fields on the "Data" tab as it is shown on the screen dump below:



  • Subject - the subject of the message
  • Message - the URL of the web page that should be sent in the body of the mail.
  • Alternate text - the URL of plain text version of the same page. This version of the mail will be used if the recipient's mail client does not support HTML mails.

Please note that the URLs used in this type of mail should be of the "External URL" type. To specify the URL click on the link in the field.

The "Insert a link" dialog will be displayed.

'

In the "Type of link" field select "External URL" and enter the URL into the "URL" field.

Mail items of all three types have five additional fields on the "Sending" tab:

'

  • From Email - the sender's email address
  • From name - the sender's name
  • Individual mails - the check box indicating whether the mail should be generated for each recipient. This option is usually used when mail body contains expansion macros, e.g. $name$
  • Recipients - the semicolon-separated list of email addresses of additional recipients.