---
title: Message boards notifications
related:
  - https://docs.kentico.com/k11/community-features/message-boards.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).

Message boards allow users to subscribe for notifications about messages that have been added to a message board.

## Who can be notified

When a new message is added or edited, the system can send notifications to:

- **Board moderators**
- **Subscribers**

The following text explains who are the notifications' recipients under specific conditions.

### New message inserted

1. The message has been added by a board moderator, user with the Global administrator [privilege level](https://docs.kentico.com/k11/managing-users/user-management.md), board owner (in case of a user board), user with the **Modify** permission, or group administrator (in case of group boards):

- the message is marked as APPROVED
- the email is sent to subscribers

2. The message has been added by anybody else

a) the board is moderated

- the message is marked as NOT APPROVED
- the email is sent to the moderators

b) the board is not moderated

- the message is marked as APPROVED
- the email is sent to the subscribers

### Existing message edited

1. The message is switched from NOT APPROVED to APPROVED

- the email is sent to subscribers

2. Other message changes

- no email is sent

## Message boards email templates

There are two different email templates that can be used when sending notifications to subscribers and board moderators:

- **Subscribers** - emails are based on the **Boards - Notification to board subscribers** template.
- **Moderators** - emails are based on the **Boards - Notification to board moderators** template.

There is also a template that is used when double opt-in is enabled - **Boards - Subscription request**.

The following macros can be used in the notification emails:

**Data macros**

- **Board.XXX** - where XXX are columns of the _Board\_Board_ table.
- **Message.XXX** - where XXX are columns of the _Board\_Message_ table.
- **MessageUser.XXX** - where XXX are columns of the _CMS\_User_ table.
- **MessageUserSettings.XXX** - where XXX are columns of the _CMS\_UserSettings_ table.

**Source macros**

- **DocumentLink** - link to the page where the board is placed.
- **SubscriptionLink** - link used to confirm the subscription when double opt-in is enabled.
- **UnsubscriptionLink** - unsubscription link.