---
title: Creating newsletters
related:
  - https://docs.kentico.com/k10/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-email-marketing/enabling-double-opt-in-for-newsletters.md
  - https://docs.kentico.com/k10/configuring-kentico/configuring-smtp-servers.md
  - https://docs.kentico.com/k10/configuring-kentico/scheduling-tasks.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Kentico enables you to create template-based and page-based newsletters, which your contacts can subscribe to on a live site. Template-based newsletters are based on a predefined template, and every email can be edited and sent manually. Page-based newsletters load their content from a specific web page and are sent out automatically according to the set schedule.

The differences and various uses of page-based and template-based newsletters are explained in the following video:

## Creating a template-based newsletter

To create a template-based newsletter:

1. Open the **Email marketing** application.
2. Click **New email feed**.
3. Select the **Newsletter** option.
4. Fill in the basic properties of the newsletter:

   | Property                      | Description                                                                                                                                                                                                                                                          |
   | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Display name                  | Name of the newsletter that is displayed in the administration interface.                                                                                                                                                                                            |
   | Code name                     | Name of the newsletter that is used as an identifier in web part properties, URLs and the API. You can leave the _(automatic)_ option to have the system generate an appropriate code name from the display name.                                                    |
   | Subscription email template   | Select the [template](https://docs.kentico.com/k10/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-email-marketing/preparing-email-templates.md) that the newsletter uses for subscription confirmation emails.   |
   | Unsubscription email template | Select the [template](https://docs.kentico.com/k10/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-email-marketing/preparing-email-templates.md) that the newsletter uses for unsubscription confirmation emails. |
   | Sender name                   | Name of the sender used in marketing emails. Authors of individual emails can override the value and set a different sender name.                                                                                                                                    |
   | Sender email address          | The email address that the newsletter uses as the sender in emails. Authors of individual emails can override the sender address.                                                                                                                                    |
5. Select the **Template-based** newsletter type.
6. Select the email template used for marketing emails.
7. Click **Save**.
   - The system creates the template-based newsletter and opens its **Configuration** tab.
8. Configure the advanced settings of the newsletter:

   | Property / Category     | Description                                                                                                                                                                                                                                                                                                                                                                                                   |
   | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Base URL                | Enter the base URL of your website (including the protocol, domain name and virtual directory). The newsletter uses the base URL to convert relative links to absolute URLs inside emails (for unsubscription links, image paths, etc.).<br>Example: _https://www.example.com/_                                                                                                                               |
   | Unsubscription page URL | The URL of the page where users can unsubscribe from the newsletter. The page must contain the **Email feed u\*\*\*\*nsubscription** web part, which ensures the required functionality.<br>If you leave the property empty, the newsletter uses the value of the **Settings -> On-line marketing -> Email marketing -> Unsubscription page URL** setting.                                                    |
   | Send draft emails to    | The addresses specified here are pre‑entered by default when sending draft emails for testing purposes. You can enter multiple addresses separated by semicolons.<br>Draft emails are not included in [tracking statistics](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing/tracking-marketing-emails.md) (email opening and link clicking). |
   | **On-line marketing**   | The properties in this category are related to tracking of the marketing emails and keeping marketing statistics.<br>See [Tracking marketing emails](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing/tracking-marketing-emails.md).                                                                                                          |
   | **Double opt-in**       | You can use the properties in this section to set up [double opt-in subscription](https://docs.kentico.com/k10/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-email-marketing/enabling-double-opt-in-for-newsletters.md) for the newsletter.                                                                                                              |
9. Click **Save**.

Now that you have created a template-based newsletter, you can [write new emails](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing/writing-marketing-emails.md) or [add recipients](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing/sending-marketing-emails.md#adding-recipients-to-newsletters).

## Creating a page-based newsletter

Page-based newsletters allow you to send out any page from your website in the form of emails. You can create a new page specifically for the purposes of a page-based newsletter. For example, to display new articles added to your website during the last month. Please note that some email clients may not be able to process and display pages exactly like a standard browser. Your developers may need to simplify the source page's content or adjust its [CSS stylesheet](https://docs.kentico.com/k10/developing-websites/designing-websites-using-css.md).

To create a page-based newsletter:

1. Open the **Email marketing** application.
2. Click **New email feed**.
3. Select the **Newsletter** option.
4. [Fill in the basic properties](#creating-a-template-based-newsletter) of the newsletter.
5. Select the **Page-based** newsletter type and enter the following details:

   | Property           | Description                                                                                                                                                                                                                                                                                                                                                        |
   | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | Source page URL    | The URL of the page from which the newsletter loads its content.<br>Clicking **Check Page URL availability** checks if the specified page is currently accessible.<br>For the purposes of this example, you can use: _<http://www.kentico.com/>_                                                                                                                   |
   | Schedule mail-outs | If enabled, the system automatically sends the page-based newsletter according to the time interval settings below.<br>For testing purposes, use a short interval such as:<br>**Period**: Minute<br>**Start time**: Click  and select the current date and time (click **Now**)<br>**Every**: 1 minute<br>**Between**: 00:00 and 23:59<br>**Days**: Check all days |
6. Click **Save**.
   - The system creates the page-based newsletter and opens its **Configuration** tab.
7. Configure the advanced settings of the newsletter:

   **Advanced properties**

   | Property / Section      | Description                                                                                                                                                                                                                                                                                                                                                                                                   |
   | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Base URL                | Enter the base URL of your website (including the protocol, domain name and virtual directory). The newsletter uses the base URL to convert relative links to absolute URLs inside emails (for unsubscription links, image paths, etc.).<br>Example: _<https://www.example.com/>_                                                                                                                             |
   | Unsubscription page URL | The URL of the page where users can unsubscribe from the newsletter. The page must contain the **Email feed u\*\*\*\*nsubscription** web part, which ensures the required functionality.<br>If you leave the property empty, the newsletter uses the value of the **Settings -> On-line marketing -> Email marketing -> Unsubscription page URL** setting.                                                    |
   | Send draft emails to    | The addresses specified here are pre‑entered by default when sending draft emails for testing purposes. You can enter multiple addresses separated by semicolons.<br>Draft emails are not included in [tracking statistics](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing/tracking-marketing-emails.md) (email opening and link clicking). |
   | Subject                 | Sets the subject of the page-based newsletter emails. You can either use the page title of the source page or enter a title manually by selecting **Use the following subject**.                                                                                                                                                                                                                              |
   | **On-line marketing**   | The properties in this section are related to tracking of the marketing emails and keeping marketing statistics.<br>See [Tracking marketing emails](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing/tracking-marketing-emails.md).                                                                                                           |
   | **Double opt-in**       | You can use the properties in this section to set up [double opt-in subscription](https://docs.kentico.com/k10/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-email-marketing/enabling-double-opt-in-for-newsletters.md) for the newsletter.                                                                                                              |

   ![creating page-based newsletters](https://docs.kentico.com/docsassets/k10/creating-newsletters/creating_page-based_newsletter.png "creating page-based newsletters")
8. Click **Save**.

Now that you have created a page-based newsletter, you can [add recipients](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing/sending-marketing-emails.md#adding-recipients-to-newsletters).
