bellDisplay notifications about events happening in the wiki.
Developed by

XWiki Development Team

Active Installs5357
0 Votes
LicenseGNU Lesser General Public License 2.1
Bundled With

XWiki Standard

Installable with the Extension Manager


This application adds a new "notifications" menu in the top bar, represented by a bell:


Since XWiki 9.10RC1, this menu is contributed by the Alerts Application and not the Notifications Application anymore.

Since XWiki 9.2RC1, you can find in this menu the notifications about some events happening on the wiki (a page has been modified, a new blog post has been posted, etc...).

The number of notifications is displayed on the top menu, just above the bell:


Since 9.2, if you have more than 20 unread notifications, you will not see the real count but this instead:


When you open the menu, the content of the notifications is loaded (before 9.11RC1, it was instantaneous):


Then you can see the list of notifications:


If you click on the little button with the "check" icon, you mark the notification as "read". In the future, you will be able to select either you want to see only unread notifications or all of them.

When the notification is read, the button disappear and the background color changes:


The "Clear All" link will remove all notifications that were sent till now.

When no notification is available, you will see the following:


In the notifications menu, you can only see notifications about someone else activity. You will not be notified for your own changes.

Group of notifications with details

Since 9.4RC1 Similar notifications are grouped together in order to avoid a batch of identical content. Only one notification is displayed, and it is possible to see the details of all activities in the "Details" section (if any). Example:

CompositeNotification.png CompositeNotification2.png

Get a notification RSS feed

Since XWiki 9.6RC1, you can get a RSS feed of the notifications occurring in your wiki. This feed can be accessed either through a link in your notification tray (or at the bottom of the notifications macro).

Notifications Macro


On the notifications menu, you also have a link to go to the "settings" of the notifications.

By default, users don't get any notification. You need to select which "types" of notifications you want to receive. When a page is created? When a blog post is published?

You can enable or disable all notification types that belong to a particular application by clicking on the bells associated to this application. If some types are enabled and other are disabled inside an application, the switch looks like the next screenshot, meaning that the application's notifications are partially enabled:


Note that when you turn on notifications you see all past notifications till now. If you wish to only see future notifications you can click on "Clear All".


since 9.8RC1 There is a "Filter" box on the bottom of the settings we have yet described.


These filters allow you to restrict on witch locations you want to receive notifications, for each event type.

To add a new filter, click on the "add a filter" button :


You will see a picker that will let you chose either a page or a wiki and a selector to choose if the filter should be inclusive or exclusive. When you select a page, the filter will also be applied on its nested pages, unless it is a terminal page.

Since XWiki 9.7RC1, you can also define exclusive filters. You can then exclude some pages from your notifications.
Note that exclusive filters take precedence over inclusive filters.

Since XWiki 9.7RC1, default notifications filters can be added to a wiki. When a default notification filter is registered, it appears as enabled in the notification center of every user.

Each user can then access the "Advanced filtering options" panel in order to enable or disable those notification filters.

9.11.3+, 10.1+ 

All filters are displayed in the same table:


Filters have been splitted into two different tables: 

  • System filters that can only be enabled or disabled, 
  • Custom filters that can be customized by users, which can be enabled or disabled and can be deleted too. Note that those filters are dedicated to filter events on specific locations.

Hidden (technical) pages

Since 9.11.3 and 10.1RC1, filters that concern hidden pages are not shown in the table, unless you have enabled the option to see hidden pages. That is why you can end up in a situation where filters exist but are not listed there.

Filter your own events

By default, one don't receive notification about her own activity. Since 9.11RC1, you have the ability to disable this filter in the "Advanced filtering options" section of your own notification settings. It's a per user setting, not a global one.

Filter events that you have marked as read

Since 9.11.3 and 10.1RC1, you can hide the notifications that you have marked as "read", so they won't appear anymore in the notifications menu nor in the emails.

Filter minor events

Since 10.2RC1 and 9.11.4, minor events are not displayed on the notifications. But you can disable this filter.

Watched Entities

Since 9.8RC1 You can also decide to watch some entities. Either a location (a page, a page with its children or a wiki) or a user (planned for 9.9). 

Enabling/Disabling the feature

Since 10.1RC1 and 9.11.4, the feature is enabled. But you can disable it if you want to use the old Watchlist Application instead.

You need to modify the following line of the file:

#-# [Since 9.8RC1]
#-# Indicate if the "watched entities" feature is enabled on the platform.
#-# This feature mimics what the "Watchlist Application" does so it may not be a good idea to have both on the platform.
#-# The default is :
# notifications.watchedEntities.enabled = true

Using it

To watch a location, all you need is to go to that place, and then click on the "alert" menu (represented by a bell). 


Here you can decide to watch either this page, this page and its children, or the entire wiki.

On the notifications settings (in your user profile), you will see the watched entities in the filters box:


The notifications settings from the user profile save which "types" of notifications you want to receive, while the options from the "alert" menu represent the pages/spaces/wiki you want to get notifications for.

Since 9.9, you won't be able to click on the buttons if you don't have enabled some event type first:


Before XWiki 11.3RC1, if a watched page is renamed, the users' filter preferences are not updated so the page might not been watched anymore after a move/rename.

Auto Watch

By default, a page where you have made a major modification is automatically added to the list of pages you watch. It means you will be notified about changes on your work. You can change this behavior in the settings:


This feature currently does not scale well. Since 10.7RC1, the default behavior for this feature is to not auto watch any page. Please see "choosing the default auto-watched mode" for more information.

The problem has been fixed in 10.8RC1 and 9.11.8 and the default behavior of this feature has been reverted.

Follow a user

If you go to the profile of an user, using the User Index for example, you can see decide to watching a user. It means you will receive all notifications about events triggered by this user.

In your user profile, if you go to the "network" tab, you can see the list of users you are watching and the events that have performed:

Coexistence with the Watchlist Application

If the Watchlist Application is installed, you will have two rows of buttons instead of one. The first row concerns the Watchlist, and the second, the notifications.


You will also receive 2 emails: one from the Watchlist, and one from the Notifications Application. That is why we recommend to uninstall the Watchlist when you use the "Watched Entities" feature.

If you upgraded your XWiki, all the pages that you watched in the Watchlist Application are automatically watched by the Notifications Application, thanks to the Notifications - Watchlist Bridge Module.


since 9.5RC1 You can also select some types of notifications that you will receive by email. You can have different choices enabled by email and in the menu. Then, on the very bottom of the page, you can select the interval between 2 emails. For example, if you choose "Daily" (default), you will receive one email every day with the recap of the events that have happened during the day. Of course, if there were no activity in this period of time, no email is sent. 

Since XWiki 9.6RC1, live notifications emails can be sent to a user. The wiki administrator can also define a "grace time" for live email notifications ; when an event that triggers a notification is sent, the platform will wait for the duration of this grace time before sending a notification email. If during this interval, a new event of the same kind is sent, the two events will be grouped in the same email. You can get more informations on how to configure this feature here.

Of course, it works only if the user has properly filled her e-mail address.

You can edit the frequency of your email notifications by using the selector just at the bottom of the notification preferences pane in your profile page :


Since 9.11RC1, the notifications are sorted by pages and dates, and a table of content summarizes all notifications contained in the email:


Since 9.11RC1, a breadcrumb is displayed on top of each notification that concern a page:


Details of the changes

Since 9.5, the changes are displayed in the email content:


Select the level of details about the changes

In the user profile of the user, you can select the level of details that you receive on the email, about the changes that have happened to the wiki:


The current choices are:

  • Standard
  • Nothing

Macros for settings

Since 9.11.3 and 10.1RC1, the application proposes different wiki macros to handle the user's settings that could be called in many pages. These macros are:

Macro UsageScreenshot
<13.2 {{notificationsFiltersPreferences/}}notificationsFiltersPreferencesMacro.png
13.2+ {{notificationsSystemFiltersPreferences/}}notificationsSystemFiltersPreferences.png
13.2+ {{notificationsCustomFiltersPreferences/}}notificationsCustomFiltersPreferences.png

Enable and disable the extension

Since 9.4RC1 The extension status can be toggled by editing the configuration variable "notifications.enabled" in and restarting the server. 

# Notifications

#-# [Since 9.4RC1]
#-# Indicates if the notification module should be enabled on the platform.
#-# The default is :
# notifications.enabled = true

Enable and disable the email feature

Since 9.5RC1, the administrator can disable the "email" notifications by editing the configuration variable "notifications.emails.enabled" in and restarting the server. 

#-# [Since 9.5C1]
#-# Indicates if the notifications module can send emails.
#-# The default is :
# notifications.emails.enabled = true

In case you have scalability issues with the feature, please contact us to describe your problem. In any case, disabling the notification emails could help.

Customize live email notifications grace time

Since XWiki 9.6RC1, the wiki users can receive live email notifications when an event is triggered in the wiki.
In order to reduce the load on the server and on your MTA, you can define a live notification grace time in with the variable The server should be restarted for the changes to take effect.

#-# [Since 9.6RC1]
#-# Indicate the grace time used when sending live email notifications.
#-# When an event is triggered in the wiki (for example, a document update), the platform will wait X minutes
#-# before sending live notifications emails. During this time, if events of the same kind are recieved, they will
#-# be grouped in the same email.
#-# The grace time define the period (in minutes) for which the platform should wait before sending a notification
#-# mail after an event.
#-# The default is :
# = 10

Threads allocated to the user notification system

Since XWiki 11.2 and 10.11.4 all the requests which are searching for notifications for the current user go trough a thread pool with low priority in order to limit the impact of this feature on the rest of the XWiki instance. By default only 2 threads are allocated but it's possible to modify this (or disable the system completly) in

#-# The search for notifications in the REST API is done trough a thread pool to limit the impact on the rest of the
#-# XWiki instance.
#-# This properties controls the size of this pool. Any number lower than 1 disable the thread pool system.
#-# The default is :


Administrators can go to Administration > Notifications to configure some settings about the notifications.


Some properties can be overridden by users. The inheritance is "Main Wiki preferences < Current Wiki preferences < User preferences".

13.2+ Administrators can also directly change users' notification settings by going to their profile and click on "Notifications" tab in the menu. The UI is the same as what the user is seeing to customize their own notification settings.

Enabling notifications for all users by default

In the administration, you can select which application and/or event types should be enabled by default for all users. 

Choosing the default level of details about the changes in the email

Administrator can select the level of details that users receive on the email, about the changes that have happened to the wiki.

Choosing the default auto-watched mode

Since 9.11.8 and 10.6RC1, administrators can select what is the default auto watching page behavior.

You can also edit the file:

#-# [Since 9.11.8]
#-# [Since 10.6RC1]
#-# The automatic watch mode used by default. The value can be changed by an administrator in the wiki's administration
#-# or by any user in their own settings.
#-# Possible values:
#-# - none:  no page is added to the list of watched pages automatically.
#-# - all:   everytime a user makes a change on a page, it is automatically added to her list of watched pages.
#-# - major: everytime a user makes a major change on a page, it is automatically added to her list of watched pages.
#-# - new:   only pages created by a user are added to her list of watched pages.
#-# The default is :
# notifications.watchedEntities.autoWatch = major

Currently, this feature does not scale well. If you have a lot of users and if they modify a lot of pages, your wiki can be broken. That is why, since XWiki 10.7RC1 and 9.11.8, the default behavior is "none" (no page is added to the list of watched pages automatically). But each user can still manually modify her own settings, and administrators can still change this value.

Customizing the notification email template

The template used for email notifications is customizable. It is stored in an XWiki.Mail object inside the page XWiki.Notifications.MailTemplate.

Since 9.11RC1, it is possible to attach images to that templates, and they will be embedded in the notifications email.

To display them in the email, you need to use the syntax <img src="cid:myImage.png" />.


Send notifications

See Tutorial: How to send notifications.

Override default notification templates in wiki pages

Since XWiki 9.6RC1, a wiki administrator can change the way notifications are displayed in the notification tray using the NotificationDisplayerClass XObject. You can get more informations about this feature in the Notifications API documentation.

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki


Dependencies for this extension (org.xwiki.platform:xwiki-platform-notifications-ui 13.2):


Get Connected