Kentico CMS 7.0 Developer's Guide

Creating a static newsletter

Creating a static newsletter

Previous topic Next topic Mail us feedback on this topic!  

Creating a static newsletter

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

In this topic, you will learn how to create a static (template-based) newsletter:


1. Go to CMS Desk -> Tools -> Newsletters and click NewNewsletter New newsletter. Enter the following details:


Newsletter display name: My newsletter; this is the name displayed to users.

Newsletter name: leave the (automatic) option; this name is used internally as an identifier in web part properties, URLs and the API. The system will generate an appropriate one based on the display name.

Subscription confirmation: Subscription confirmation template

Unsubscription confirmation: Unsubscription confirmation template

Sender name: Enter your full name

Sender e-mail: Enter your e-mail address


Choose the Template-based newsletter option and use the Newsletter issue template. Click Save Save. The newsletter will be created and you will be redirected to its Configuration tab, where the following additional options can now be set:


Base URL - here you can specify the base URL of your website (protocol, domain name and virtual directory), which is used to convert relative links to absolute URLs in newsletter issues. It may be necessary to set this property in order for the unsubscription links to work properly. It's also useful if you encounter any issues with links in newsletter e-mails, e.g. if you are using a different URL for your editing environment than for the live website.

Unsubscription page URL - enter ~/SpecialPages/Unsubscribe/Newsletter.aspx. This page on the sample Corporate site contains a Newsletter unsubscription web part, which ensures the required functionality.

Send draft e-mails to - the addresses specified here are pre‑entered by default when sending draft newsletter issues for testing purposes. Multiple addresses must be separated by semicolons. Draft e-mails are not included in tracking statistics (e-mail opening and link clicking).

Send issues via e-mail queue - if enabled, newsletter issues will be sent to the SMTP server through the E-mail queue. This is recommended for newsletters with a large number of recipients. If disabled, the issues will be sent directly to the SMTP server.

Enable resending - if enabled, it will be possible to edit newsletter issues and manually send them again even after they have been mailed out to subscribers. You can disable this property to ensure that subscribers do not accidentally receive the same content multiple times. Issues that utilize A/B testing are an exception and can never be re-sent.


On-line marketing - the properties in this section are related to tracking of the newsletter's e-mails and keeping marketing statistics. Please see the On-line marketing chapter for further details.


Double opt-in - the properties in this section are related to double opt-in subscription. Please refer to the Double opt-in topic for more information.




Click Save Save again.


2. Now we will create a new subscriber. Select the main Subscribers tab in the left menu and click the AddNewSubscription New subscriber button. Enter the following details:


E-mail - subscriber's e-mail address. If you wish to check the newsletter e-mail once it is sent, enter a valid address that you can access.

First name - subscriber's first name.

Last name - subscriber's last name.




Click Save Save to add the subscriber.


3. Now we will assign this subscriber to our previously created newsletter. Switch to the Subscriptions tab, click the NewNewsletter Add newsletters button, check the box next to My newsletter in the selection dialog and click OK.



If you check the Send e-mail confirmation to the subscriber box before adding a newsletter to a subscriber, an e-mail informing about the subscription will be sent to them. If you check the Require double opt-in box, subscriptions to newsletters that have double opt-in enabled will be inactive (rejected) until the user confirms them or the Approve (Approve) action is manually selected in the list of subscriptions.


4. Your newsletter is configured. You can now create new issues as is described in the Authoring static newsletter issues topic.