View source for Help:Notifications

{{for|the essay describing how to notify editors of administrative issues involving them|RetroWikipedia:Notification}}
{{Redirect|WP:ECHO|the WikiProject|RetroWikipedia:WikiProject Echo|the how-to on fixing failed pings|Help:Fixing failed pings}}
{{pp-protected|reason=Persistent [[WP:Disruptive editing|disruptive editing]]|small=yes}}
{{Information page|WP:ECHO|WP:PING|H:NOTIFS}}
{{Infobox software
| name                   = Notifications (formerly Echo)
| logo                   = [[File:Notifications (Echo)-logo.svg|frameless|Logo of the Notifications project, Wikimedia Foundation Engineering]]
| screenshot             =
| caption                = 
| developer              = [[WP:Wikimedia Foundation|Wikimedia Foundation]]
| genre                  = [[Notification system]]
| website                = [[mw:Notifications|Notifications @ MediaWiki.org]]
}}

'''Notifications''' (commonly called '''pinging''', formerly known as '''Echo''') is a system designed to inform users about new activity on RetroWikipedia in a unified way. Rolled out at the end of April 2013, 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 [[Help:Watchlist|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 [[Special:Preferences#mw-prefsection-echo|Preferences]].

You can "mention" a user called [[User:Example|Example]] by making an edit with a link to their user page (writing <code><nowiki>[[User:Example]]</nowiki></code>, {{tlxi|u|Example}}, {{tlxi|User|Example}}, {{tlxi|User link|Example}}, {{tlxi|Ping|Example}}, {{tlxi|Yo|Example}}, or {{tlxi|Reply to|Example}}) '''and''' [[RetroWikipedia:Signatures|signing]] the edit using four tildes (<nowiki>~~~~</nowiki>). The user "Example" will then get a notification saying where they were mentioned. This is sometimes called "pinging". See [[Help:Talk pages#Notifications]] for more information.

Before Notifications, the only notifications that the MediaWiki software provided were given through emailed notifications for changes to your [[Special:Watchlist|watchlist]], and an orange bar for changes to your user talk page. Because not everyone would use watchlists, it was common before Notifications to respond to a talk page message by going to the other user's talk page to reply. To learn more about Notifications, visit [[mw:Echo (Notifications)|the project hub]] on MediaWiki.org.

== Viewing notifications ==
{{anchor|Alerts|Notices}}
=== Toolbar icons ===
<gallery widths="90" heights="50">
 Notifications alert badge - 1 alert.svg|Alert badge
 Notifications notice badge 1 notice.svg|Notice badge
</gallery>

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|cross-wiki notifications]]. When there are no notifications, these badges are grey.

The first badge (red, "alerts") contains more important notification types: new messages on your talk page, mentions, etc. The second badge (blue, "notices") contains less important notifications: page links, messages 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 [[Special:Notifications|notifications archive]].

=== Notification layout ===
[[File:Mark as read transition.gif|thumb|360px|Mark notifications as read and unread.]]
The most common notification types are all designed with the same pattern:

: An icon floated on the left (on the right for right-to-left languages)
: A circle floated on the right:
:* filled with blue if the notification is unread
:* white and circled of grey when read
: Primary information: Notification title, in bold
: Secondary information: Notification details (optional)
: Details: at the bottom, with some useful information:
:*always the user who performs the action (with a link to their userpage) and date in a relative format
:*sometimes other information, like the targeted page
:*if needed, a three-dots menu with some options

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

Unread notifications may be marked as read without following the link, by clicking on the blue circle; similarly, notifications that are shown as read may be marked as unread (for example, if you want to return to it later) by clicking the grey circle. Unread notifications do not remain indefinitely - they are automatically removed after about 16 months.

Similar notifications or notifications from other wikis are grouped.

=== Special:Notifications page ===
To find all your recent notifications, click on "All notifications" in the fly-out to go to the [[Special:Notifications|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.

{{anchor|Triggering events|Notification messages}}

== Types of 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|cross-wiki notifications]], or on the page [[Special:Notifications|Special:Notifications]].

Some of these notifications are turned off by default or not available on the English RetroWikipedia. If you would like to enable any of these notifications (or disable them), you can do so [[Help:Notifications#preferences|in your preferences]].

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

[[Special:TopicSubscriptions]] lists all discussions you are subscribed to ([[WP:SUBSCRIBE|Topic Subscriptions]])

=== Messages on your talk page ===
[[File:Echo edit-user-talk icon.svg|30px|Talk page message icon]] '''Alerts'''—Received whenever someone posts a new comment in a discussion you are [[RetroWikipedia:SUBSCRIBE|subscribed to]], or 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 multiple new messages or multiples replies, messages may be grouped ("six new messages on [that page]").
: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.

{{anchor|Mentions|Mention|mentions|mention}}

=== Mentions ===
{{shortcut|WP:MENTION}}
[[File:Echo mention icon.svg|30px|Mention icon]] '''Alerts'''—Received when someone mentions you on a talk page.

: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:

* Create a new comment; modifying an earlier comment does not work.
* Link to their username
** either directly as in <code><nowiki>[[User:Username]]</nowiki></code>
** or using templates that link a user's name like {{tl|u}} if they exist on your wiki (many use the {{tl|ping}} or {{tl|reply to}} templates).
* {{anchor|signed}}Sign your comment with <code>~&#126;~</code> or <code>~&#126;~~</code>. Notifications will not be sent if your signature is embedded in a template, or has no link to your user page or user talk page.
* Not alter any text outside your own comment.
* Not exceed 50 mentions.
{{shortcut|WP:PINGIP}}
Note:

* Notifications are only sent to registered users; '''notifying anonymous users (IPs) by mentioning their IP address is not possible'''.
* You cannot notify yourself.

Specific and additional technical details are at [[mw:Manual:Echo]].

{{anchor|EditSummary|Edit summary|Edit summaries|edit summary|edit summaries}}
==== Mentions in edit summaries ==== 
[[File:Echo mention icon.svg|30px|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.
:Details: link to the user who mentioned you.

To mention a user, just link to their user page, using the normal wikitext syntax: <code><nowiki>[[User:Username]]</nowiki></code>. All the usual link styles work, like <code><nowiki>[[User:Username|some text]]</nowiki></code> or <code><nowiki>[[User:Username|Username]]</nowiki></code>. <code><nowiki>[[User:Username|]]</nowiki></code> will work, but it will display <code><nowiki>User:Username</nowiki></code> 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 <code>:</code>, like this: <code><nowiki>[[:User:Username]]</nowiki></code>.

==== Successful mentions ==== 
[[File:Notifications - Successful Mention - August 2016.png|thumb|upright=1.5]]
[[File:Echo mention-success.svg|30px|Successful mention icon]] '''Notices'''—Received when your mention has been sent to other user.

: Primary information: who you mentioned.
: Details: link to the page you mentioned the user on.

==== Failed mentions ==== 
[[File:Notifications - Failed Mention - August 2016.png|thumb|upright=1.5]]
[[File:Echo mention-failure.svg|30px|Failed mention icon]] '''Alerts'''—Received when your mention to other user was not sent.

: Primary information: who you tried to mention, and the reason the mention was not sent.
: Details: link to the page you tried to mention on.

These notifications are sent when:
* trying to mention an anonymous user or users that does not exist, or
* exceeding the limit of mentioned users in a single edit (currently 50).

=== Reverted edits ===
[[File:Echo revert icon.svg|30px|Edit reverts icon]] '''Alerts'''—Received when your edits are [[WP:UNDO|undone]] or [[WP:ROLLBACK|rolled back]].

:Primary information: Who reverted you, and where. Links to the diff.
:Details: link to the user who reverted you.

=== Email received ===
[[File:Notifications - Email received - January 2016.png|thumb|upright=1.5]]
[[File:Echo emailuser icon.svg|30px|Emails from other users icon]] '''Alerts'''—Received when someone emailed you through the wiki.
:Primary information: Who emailed you. No link given for 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.

=== User rights changes ===
[[File:Notifications - Changed rights - January 2016.png|thumb|upright=1.5]]
[[File:Echo user-rights icon.svg|30px|User rights icon]] '''Alerts'''—Received when your [[WP:UAL|user rights]] change. Doesn't include if it's automatic, like when you become [[WP:AUTOCONF|autoconfirmed]] or [[WP:EXTENDEDCONF|extended confirmed]].

:Primary information: what has been changed, and by who. Links to [[Special:UserGroupRights]] page.
:Details: link to the user who changed your rights.

=== Failed login attempts === 
[[File:Notification for failed login attempt.png|thumb]]
<!-- Please replace with specific icon: [[File:Notifications alert badge - 1 alert.svg|34px|alt=Alert icon]]--> 
'''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 [[mw:Help:Login notifications#How does this feature work?|login notification documentation]] for more information.

=== Welcome ===
[[File:Notifications - Welcome - January 2016.png|thumb|upright=1.5]]
<!-- Please replace with specific icon: [[File:Notifications notice badge 1 notice.svg|34px|alt=Notice icon]]--> 
'''Notices'''—Received when you have just created your account.
:Primary information: Welcome! 
:Details: link to a welcome page as defined on the wiki configuration ([[MediaWiki:Notification-welcome-link]]).

{{anchor|Milestone}}
=== Milestone === 
[[File:Notifications - First milestone - August 2016.png|thumb|upright=1.5]]
[[File:OOjs UI icon edit-ltr-progressive.svg|30px|Milestone edit icon]] '''Notices'''—Received when you reach certain edit count milestones. 

The current milestones are powers of ten (1st, 10th, 100th, 1,000th, 10,000th, 100,000th, 1,000,000th and 10,000,000th edits).<ref>https://en.wikipedia.org/wiki/Special:AllMessages?prefix=notification-header-thank-you-&filter=all&lang=en&limit=5000</ref>

:Primary information: Which milestone you've reached, and which edit triggered the notification.

=== Thanks ===
[[File:Notifications - Thanked edit - January 2016.png|thumb|upright=1.5| Thank for an edit on a page]]
[[File:OOjs UI icon userTalk-ltr-constructive.svg|30px|thanks notice icon]] '''Notices'''—Received when [[WP:THANKS|someone thanks you]] for your edit.

:Primary information: Who thanked you, where, and about what. Linked to the diff 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.

Available by default, but it is possible to opt-out into Preferences.

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

{{anchor|echo-category-title-article-linked}}

=== Links to articles you created ===
[[File:OOjs UI icon link-ltr-progressive.svg|30px|page links notice icon]] '''Notices'''—Received when a new link is made to a page you created.

:Primary information: The page that you created, and where it was linked from. Links to the page that has the new link.
:Details: link to "What links here" page for the targeted page.

You can mute these notifications for individual pages, either: 
*  from [[Special:Preferences#mw-prefsection-echo|your preferences]] ([[#mute|see how to]])
*  via a given notification, by clicking on the three dots.

=== Page patrolled ===
[[File:OOjs UI icon articleCheck-ltr-progressive.svg|30px|page review notice icon]] '''Notices'''—Received when a page which you created is reviewed (or "patrolled") by a [[WP:NPP|new page patroller]].

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

=== Connection to Wikidata === 
[[File:Notifications - Wikidata connection.png|thumb|upright=1.5]]
[[File:OOjs UI icon Wikidata Echo.svg|30px|Wikidata connection icon]] '''Notices'''—Received when your page is connected to [[RetroWikipedia:Wikidata|Wikidata]].

: Primary information: the name of the page that was connected.
: Details: link to the data item and, possibly, to a local help page.

=== Cross-wiki === 
Cross-wiki notifications are displayed on both panels, and regroup notifications from other Wikimedia Foundation hosted wikis. For example, while on the English RetroWikipedia, 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 RetroWikipedia would be grouped with notifications from other wikis. [[mw:Help:Notifications/Cross-wiki|Learn more about cross-wiki notifications.]]

=== OAuth ===
; OAuth development
:  notifies developers of OAuth applications when the review status of the application has changed.
; OAuth admin
:  notifies OAuth admins about new applications waiting for review.

== Preferences and settings == 

{{anchor|preferences}}
=== Access to preferences === 
You can control what kinds of notifications you get (and how often) by updating your [[Special:Preferences#mw-prefsection-echo|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.)

=== Opt-in and opt-out === 
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.

=== Notifications by email or on wiki === 
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.

{{anchor|mute}}
=== Muting users ===
{{See also|RetroWikipedia:Community health initiative on English RetroWikipedia/User Mute features#Notifications Mute}}
You can mute on-site notifications from individual users, by typing their username into the box at the bottom of the [[Special:Preferences#mw-prefsection-echo|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, 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.

=== Muting pages === 
Muting pages is possible for "page linked" notifications.

You can mute "page linked" notifications for a page by typing the page name into the box at the bottom of the [[Special:Preferences#mw-prefsection-echo|notifications preferences]].

When you start typing, the page titles will autocomplete.

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

{{anchor|Blacklist and whitelist}}
=== Community blacklisting === 
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|Special:MyPage/Echo-whitelist]].

==Known bugs==
There are a number of [[Software bug|bugs]] currently known with the notifications system:

* '''Failure to spot signatures'''. In some cases (usually when changing another, recent, comment with a signature) the parser does not realise that a user has made a new signed comment, and so does not trigger a notification. The technical requirements for notifications to work are described in [[mw:Help:Echo#Technical details|mw:Help:Echo § Technical details]].
* '''Confusing section titles'''. On pages with complicated markup, or after edit conflicts, the notification will sometimes give the wrong section heading for a message.
* '''Transclusion'''. Because a notification is generated whenever a page is linked to, accidental [[RetroWikipedia:Transclusion|transclusion]] of other pages can cause a sudden flurry of unintentional notifications through links on the transcluded page.

For all open Notifications related bugs, see {{Plain link|url=https://phabricator.wikimedia.org/project/sprint/board/182/query/open/ |name=the list on Phabricator}}.

==See also==
* [[Help:Fixing failed pings]]
* {{tl|Interwiki talkback}} &ndash; a "you have new messages" notice to put on other users' talk pages for interwiki purposes
* {{tl|You've got mail}} &ndash; notifies of an offsite e-mail
* {{tl|Reply to}} &ndash; aka Ping
* [[RetroWikipedia:Software notices]]
* [[Help:Talk pages#You have new messages|"Peach bar of doom"]] &ndash; a banner notifying unregistered users of new talk page messages
* [https://diff.wikimedia.org/2013/02/07/echo-a-new-notification-system-for-wikipedia/ Echo: A new notification system for RetroWikipedia], 7 February 2013 by Fabrice Florin

==Notes==
{{commonscat|Echo (Notifications) extension}}
<references />

{{RetroWikipedia technical help|collapsed}}

[[Category:RetroWikipedia features]]