Help:Notifications

Notifications (formerly known as Echo, commonly called pinging) is a system designed to inform users about new activity on Wikipedia in a unified way. It provides notifications to users for a number of events related to their account, including new talk page messages, edit reverts, mentions or links. It is intended to augment the Watchlist, by highlighting key user interactions.

Notifications are displayed to the right of the username and user talk links in the top link bar of the page for logged-in users, displaying two icons, each with a number representing the number of recent notifications. Email notifications can also be set up for some or all types of notification in Preferences.

Before Notifications, the only notifications that the MediaWiki software provided were given through emailed notifications for changes to your watchlist, and an orange bar for changes to your user talk page. To learn more about Notifications, visit the project hub on MediaWiki.org.

Notifications are either alerts or notices depending on the importance of the message. When someone takes an action that affects you, colored badges will appear next to your username, in the top right corner of any page. These notifications include cross-wiki notifications. When there are no notifications, these badges are grey.

The first badge (red, "alerts") contains most important notification types: new messages on your talk page, mentions, etc. The second badge (blue, "notices") contains less important notifications: pages links, message on other talk pages, etc.

These badges will show the number of new notifications you've received. Clicking on the badges will display a "fly-out" listing the most recent notifications (see screenshot) and set the badge color to grey again. The number will stay different from zero until you mark-as-read all your notifications for this badge (especially for messages).

You can click on the notification of your choice to find out more about it (see description below). To see all notifications received, you can click on "All notifications" to go to the notifications archive.

The most common notification types are all designed with the same pattern:

The whole notifications is a link, usually to a diff that is related to the action you are notified about.

To find all your recent notifications, click on "All notifications" in the fly-out to go to the notifications page. On that page, all notifications are displayed by date. Your most recent notifications are listed first on this archive page. On Wikimedia wikis, that page also regroups cross-wiki notifications.

All types of notifications below can be seen on Wikimedia wikis. You can see them on the wiki where you are, on another wiki via cross-wiki notifications, or on the page Special:Notifications.

Some of these notifications are turned off by default or not available on the English Wikipedia. If you would like to enable any of these notifications (or disable them), you can do so in your preferences.

Special:DisplayNotificationsConfiguration lists all notification types available and how they are configured.

Details: Link to the user page of the last user who left you a message for that group.

This notification replaces the orange bar that used to appear, but you can set up your preferences to have the orange bar.

Primary information: Who mentioned you, where, and about what. Linked to the page you are mentioned in.
Details: link to the user who mentioned you and the diff where you are mentioned.

To mention another editor and trigger this notification for them, you need to:

Mention icon Alerts — Received when someone links to your user page in an edit summary.

Primary information: Who mentioned you, where, and the edit summary. Linked to the change in question.

To mention a user, just link to their user page, using the normal wikitext syntax: [[User:Username]]. All the usual link styles work, like [[User:Username|some text]] or [[User:Username|Username]]. [[User:Username|]] will work, but it will display User:Username with a link to the user page on the History page. No more than 5 users can be mentioned in an edit summary. Mention templates don't work in edit summaries. There is no requirement that the edit itself creates a new comment, so this method can be used when you modify a comment.

To leave a link in the summary without notifying a user, prefix username with :, like this: [[:User:Username]].

Primary information: who you tried to mention, and the reason the mention was not sent.
Primary information: Who emailed you. No link given for this information.

People can send you emails only if you have allowed this on your preferences.

User rights icon Alerts — Received when your user rights change. Doesn't include if it's automatic, like when you become autoconfirmed or extended confirmed.

Primary information: what has been changed, and by who. Links to Special:UserGroupRights page.

Alerts — Received when someone attempted and failed to log in to your account.

Multiple alerts are bundled into one for attempt from a new device/IP, but for a known device/IP, you get one alert for every 5 attempts. See the login notification documentation for more information.

Details: link to a welcome page as defined on the wiki configuration (MediaWiki:Notification-welcome-link).

The current milestones are powers of ten (1st, 10th, 100th, 1,000th, 10,000th, 100,000th, and 1,000,000th edits)

Primary information: Which milestone you've reached, and which edit triggered the notification.
Primary information: Who thanked you, where, and about what. Linked to the diff or to the message on Flow that you are thanked for.
Details: link to the user who thanked you, and if it was on a Structured discussion board to the page.

You can thank someone from any History page, from a diff comparison, or in your watchlist. Remember this thank is stored in a public log (Special:Log/thanks).

Primary information: The page that you created, and where it was linked from. Links to the page that has the new link.

page review notice icon Notices — Received when a page which you created is reviewed (or "patrolled") by a new page patroller.

Primary information: Which page has been reviewed, and who reviewed it.

Cross-wiki notifications are displayed on both panels, and regroup notifications from other Wikimedia Foundation hosted wikis. For example, while on the English Wikipedia, you can receive notifications from Commons, and these will be grouped together with notifications from other wikis like Wikivoyage. On Commons, the project-specific notifications would be ungrouped, and notifications from the English Wikipedia would be grouped with notifications from other wikis. Learn more about cross-wiki notifications.

notifies developers of OAuth applications when the review status of the application has changed.

You can control what kinds of notifications you get (and how often) by updating your notifications preferences. To check your settings, click on "Preferences" in the fly-out (shown above) – or in the "All notifications" archive page. (You can also click on "preferences" in the top right of any page, then select the "Notifications" tab.)

If you opt out of any type of notifications, then these notifications generated while you were opted-out are not generated for you and not stored in databases. Opt-in will not display them afterwards. The only notifications that may be displayed are the one that existed before the opt-out.

To turn notifications on or off for any category, simply check (or uncheck) the box next to it. You can enable (or disable) notifications on the web or by email for most categories. (Some notifications cannot be disabled, such as changes to your user rights or new talk page messages: these notifications are too important to be dismissed.) You can also control how often to receive email notifications, from single emails for each event to daily or weekly digests. When you're done, be sure to click the "Save" button at the bottom of the page to update your preferences.

You can mute on-site notifications from individual users, by typing their username into the box at the bottom of the notifications preferences. When you start typing, the usernames will autocomplete. Users without JavaScript should type one username per line, without any wikitext or prefix.

You will still receive notifications if a muted user writes or participates on your user talk page (no matter if the page uses Flow or unstructured wikitext), or reviews a page you have created. Watchlist behavior and emails are not affected by the mute list.

The muted user will still receive a successful mention notification, if they've enabled that preference. A user's mute list is private from all other users on the wiki, including administrators or any other functionary.

You can mute "page linked" notifications for a page by typing the page name into the box at the bottom of the notifications preferences.

Users without JavaScript should type one page title per line, without any wikitext or prefix.

There is a site-wide list of accounts that cannot trigger notifications at MediaWiki:Echo-blacklist, which can be overridden by users at Special:MyPage/Echo-whitelist.

There are a number of bugs currently known with the notifications system: