Help:Notifications



Welcome to the documentation page for the hub>Echo (Notifications)|Notifications tool! (formerly code-named Echo)

To customize which notifications you receive, go to the prefs>Special:Preferences#mw-prefsection-echo|"" tab of your  on the site. Once you've tested Notifications, please join the discussion on talk>Talk:Echo (Notifications)|this talk page.

== Principle ==

The hub3>Echo (Notifications)|Notifications tool (formerly code-named Echo) gives users of Wikipedia and other Wikimedia sites quick updates about actions that affect them. These notifications can help users become more aware of events that relate to them and take quick action if they want to.

This software was developed by the Wikimedia Foundation's editor-engagement>m:w:Wikipedia:Editor engagement|editor engagement team and now the Collaboration team, to encourage people to participate more actively on Wikimedia sites. Notifications are designed to replace or augment existing notification systems on these sites, as well as provide significantly more control to users.

Before Notifications, the only notifications that the MediaWiki software provides are given through watchlist>Special:Watchlist|the watchlist. The watchlist is quite helpful, but its format is limited. It works well for changes related to pages, but not so well for changes related to users. At the same time, there's no granularity: if a page is watchlisted, you are informed about every change that happens to it. If a change is not watchlisted, you receive none. Watchlists are useful, and they work well for the job they were designed for, but they don't encompass the whole scope of on-wiki activity. Notifications feature, in conjunction with watchlists, can provide a better user experience. Users are able to learn about more events, far more easily, and have greater control over what kind of information they receive.

To learn more about Notifications, visit hub4>Echo (Notifications)|this project hub on MediaWiki.org.

== Use ==

Notifications are for all registered users of Wikipedia and other Wikimedia sites. Unregistered users cannot get notifications (except for talk page notifications, which are still shown to anonymous users in an orange bar). === What you see ===

==== Default display, before an action ==== When someone takes an action that affects you on a Wikimedia site, colored badges will appear next to your user name, in the top right corner of any page of that site (except for crosswiki>Special:MyLanguage/Help:Notifications/Cross-wiki|cross-wiki notifications). These badges are usually grey.

The first badge (red, "alerts") contains most notification types; the second badge (blue, "messages") contains notifications about your user talk page messages. These badges will show the number of new notifications you've received. Clicking on the badges will display a flyout listing the most recent notifications (see screenshot) and set the badge color to grey again. The number will stay different from zero until you have mark-as-read all 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 "" to go to the spec-notifs>Special:Notifications|notifications archive.

==== Detailed notification layout ==== Here are the most common notifications you can receive. They are all designed with the same pattern: The whole notifications is a link, mostly to a diff related to the action you are noticed for. === The different notifications === Some of these notifications are turned off by default. If you would like to enable any of these notifications (or disable them), you can do so in your preferences, as described further below.
 * 1) an icon floated on the left (on the right for right-to-left languages)
 * 2) Primary information: Notification title, in bold
 * 3) Secondary information: Notification details (optional)
 * 4) Details: at the bottom, with some useful information:
 * 5) * always the user who performs the action (with a link to his userpage) and date in a relative format
 * 6) * sometimes other information, like the targeted page

==== Talk page messages ==== Message (blue) notification, when a message is left on your user talk page.
 * Primary information: Message title
 * Secondary information :
 * in case of a new message: who left the message, and on which page. Links directly to the message.
 * in case of a reply: who reply the message, and on which page. Links directly to the section title, or, with Flow, to the message itself.
 * in case of multiple new messages or multiples replies, messages may be grouped ("six new messages on [that page]")
 * Details: link to the user who left you a message

This notification replaces the orange bar that used to appear, but you can setup your preferences to have the orange bar. ==== Page linked ==== Alert (red) notification, when a new link is made to a page you created.
 * Primary information: Who mention you, and where.
 * Secondary information
 * Details

==== Edit reverts ==== Alert (red) notification, when your edits are undone or rolled back
 * Primary information: Who reverted you, and where.
 * Details: link to the user who reverted you

==== Thank ==== Alert (red) notification, when someone thanks you for your edit;
 * Primary information: Who mention you, where, and about what. Linked to the diff, or to the message on Flow you are thanked for.
 * Details: link to the user who thank you page and the page where was the edit.

You can thank someone from any History page, from a diff comparison, in your watchlist or in Flow. This thank is public.

==== User rights ==== Alert (red) notification, when your user rights change.
 * Primary information: what has been changed, and by who. Links to Special:UserGroupRights page.
 * Details: link to the user who changed your rights

==== Welcome ==== Alert (red) notification, when you have just created your account.
 * Primary information: Welcome ! Links to a welcome page as defined on the wiki configuration.

==== Email from user ==== Alert (red) notification, when someone sent you an email trough the wiki.
 * Primary information: Who sent you an email. No link on this information.
 * Details: link to the user who sent you this email

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

==== Cross-wiki ==== Cross-wiki notifications are displayed on both panels, and regroup notifications from other Wikimedia Foundation hosted wikis. By this way, you can receive notifications about Commons when you are on Wikisource. Learn more about cross-wiki notifications.

=== See all notifications received ===

To find all your recent notifications, click on "</>" in the flyout to go to the spec-notifs2>Special:Notifications</>|notifications archive page. Your most recent notifications are listed first on this archive page. To see older notifications, click on the "<tvar|more></>" button at the bottom of that page.

== Preferences and settings ==

You can control what kinds of notifications you get (and how often) by updating your prefs2>Special:Preferences#mw-prefsection-echo</>|notifications preferences. To check your settings, click on "<tvar|pref></>" in the flyout (shown above) -- or in the "<tvar|link></>" archive page. (You can also click on "<tvar|pref></>" in the top right of any page, then select the "<tvar|echo></>" tab.)

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 "<tvar|save></>" button at the bottom of the page to update your preferences.

== Feedback ==

We'd love to hear what you think of notifications. To discuss your suggestions with other users, visit talk>Talk:Echo (Notifications)</>|this project talk page.

If you find a bug, you are welcome to report it bug>phabricator:tag/mediawiki-extensions-echo</>|here on Phabricator. However, we appreciate that Phabricator isn't exactly the easiest system to use; you can also drop the report on talk>Talk:Echo (Notifications)</>|the project talkpage, with a screenshot and information on your browser and operating system :).