View source for Help:Edit summary

{{pp-semi-indef|small=yes}}
{{infopage|H:ES|WP:ES}}
{{nutshell|When editing, be sure to summarize your contributions.}}
{{clear}}

An '''edit summary''' is a brief explanation of an [[Help:editing|edit]] to a Wikipedia page. When you edit a page, there is a small text entry field labeled ''Edit summary'' located under the main edit box and above the ''Publish changes'' button:

{{EditOptions|align=center|width=90%|font-size=85%|caption=The edit summary field appears above the "Publish changes" button}}

It is good practice to fill in the edit summary field, or add to it in the case of [[#Section editing|section editing]], as this helps others to understand the intention of your edit. Edit summaries are displayed in lists of changes (such as [[Help:Page history|page histories]] and [[Help:Watching pages|watchlists]]), and at the top of [[Help:Diff|diff]] pages.

==Always provide an edit summary==
{{shortcut|H:FIES|WP:FIES}}
'''It is considered good practice to provide a summary for every edit''', especially when [[WP:Reverting|reverting]] (undoing) the actions of other editors or deleting existing text; otherwise, people may question your motives for the edit. Edits that do not have an edit summary are more likely to be reverted, because it may not be obvious what the purpose of the edit was. 

Accurate summaries help other contributors decide whether it is worthwhile for them to review an edit, and to understand the change should they choose to review it. When a major edit (e.g. deletion of a substantial amount of text, a significant addition, or a substantial rewrite) doesn't have an edit summary, there are fewer reasons to [[WP:AGF|assume good faith]] and busy editors may be more inclined to revert the change without checking it in detail. Summaries are less important for ''[[Help:Minor edit|minor changes]]'' (which means generally unchallengeable changes such as spelling or grammar corrections), but a brief note like "fixed spelling" is helpful even then.

To avoid accidentally leaving edit summaries blank, you can select "Prompt me when entering a blank edit summary" on the ''Editing'' tab of your [[Special:Preferences|user preferences]], if you have [[Wikipedia:Why create an account?|created an account]].

{{Clear}}

==How to write an edit summary==
{{shortcut|WP:EDITSUMCITE}}
{{main|Wikipedia:Edit summary legend}}
* ''Summarize''. Summarize the change, even if only briefly; even a short summary is better than no summary. 
* ''Explain''. Give reasons for the change, if you think other editors may be unclear as to why you made it. Citing the Wikipedia policies or guidelines that you feel justified the change may be incorporated into your explanation. 
* ''Abbreviations''. Abbreviations should be used with care. They can be confusing for new contributors. For an explanation of some commonly used abbreviations, see this [[WP:ESL|edit summary legend]].
* ''Expand on important information''. Readers who see only the summary might not get the entire picture. Prevent misunderstanding: If an edit requires more explanation than will fit in the summary box, post a comment to the article's [[WP:TALK|talk page]] to give more information, and include "see talk" or "see discussion page" in the edit summary.
** If you are [[Wikipedia:Copying within Wikipedia|copying text within Wikipedia]], you must at least put a link to the source page in the edit summary at the destination page.
* ''Talk pages''. When editing [[WP:TALKPAGE|talk pages]], consider reflecting the gist of your comment in the edit summary; this allows users to check Recent changes, Page history and User contributions (see below) very efficiently.

=== What to avoid in edit summaries ===
{{shortcut|WP:SUMMARYNO}}
* ''Avoid misleading summaries''. Mentioning one change but not another one can be misleading to someone who finds the other one more important. You could add something like "and misc." to cover the other changes.
* ''Avoid vagueness''. While edit summaries can be terse, they should still be specific. Providing an edit summary similar to "I made some changes" is functionally equivalent to not providing a summary at all.
* ''Avoid long summaries''. Edit summaries are not for writing essays about 'the truth' or longwinding arguments with fellow editors. For discussions, you should use the talk page.
* ''Avoid inappropriate summaries''. You should explain your edits, but without being overly critical or harsh when editing or reverting others' work. This may be perceived as [[WP:INCIVILITY|uncivil]], and cause resentment or conflict. Explain what you changed, citing the relevant policies, guidelines or principles of good writing, but do not target others in a way that may come across as a [[WP:No personal attacks|personal attack]].
* ''Avoid incivility. ''Snide comments, personal remarks about editors, and other aggressive edit summaries are explicit [[WP:Civility#Edit summary dos and don'ts|edit-summary "don't's"]] of the Wikipedia [[WP:CIVIL|Civility policy]].

===Use of edit summaries in disputes===
{{shortcut|WP:REVTALK}}
Proper use of edit summaries is critical to resolving [[Wikipedia:Dispute resolution|content disputes]]. Edit summaries should accurately and succinctly summarize the nature of the edit, especially if it could be controversial. If the edit involves [[Help:Reverting|reverting previous changes]], it should be marked as a revert ("rv") in the edit summary.

Avoid using edit summaries to carry on debates or negotiation over the content or to [[WP:NPA|express opinions of the other users involved]]. This creates an atmosphere where the only way to carry on discussion is to revert other editors! If you notice this happening, start a section on the talk page and place your comments there. This keeps discussions and debates away from the article page itself. For example:

:''reverted edits by [[User:Example]], see talk for rationale''

===Fixing===
After you publish the page, you cannot change the edit summary, so be careful with it, particularly if you are in a heated content dispute&nbsp;– do not write things you will regret.

If you make an important omission or error in an edit summary, you can correct this by making a [[Help:Dummy edit|dummy edit]] (a change in the page with no visible effects), and adding further information in its own edit summary.

In the extreme case of an edit summary containing certain kinds of harmful content, the summary can be deleted on request. They may be removed from public view by [[WP:ADMIN|administrators]] using [[WP:REVDEL|Revision Deletion]]; such edit summaries remain visible to administrators. In even more limited circumstances the entire edit may be [[WP:OVERSIGHT|oversighted]], leaving it and its edit summary visible only to the handful of users with the Oversight permission.

==Edit summary properties and features==
* ''[[#The 500-character limit|Limited to 500 characters]]''. The edit summary box can hold one line of approximately 500 characters. If you attempt to type or paste more, only the first 500 will be displayed – the rest will be discarded. For example, attempting to add 10 new characters (at the end or in between) to a summary already containing 495 characters may result in the first 5 new characters being inserted and the second 5 being disregarded.
* ''Show preview''. The "Show preview" button also provides a preview of the edit summary to facilitate checking links.
* ''Can't be changed after saving''. After you publish the page, you cannot change the edit summary (see bugs [[bugzilla:10105|10105]] and [[bugzilla:13937|13937]]).
* ''Doesn't appear in searches''. The built-in [[Help:Searching|search function]] cannot search edit summaries, and they are not indexed by external search engines.
* ''Wikilinks always rendered; other wikitext coding ignored''. Edit summaries render internal links, including [[Help:Piped link|piped links]], and [[Help:Interwiki linking|interwiki]] links, even when enclosed within {{tag|nowiki}} tags. Therefore, copying wikitext in the edit summary box may be preferable to copying text from the preview, except when one wants to save space. Other wikitext coding is not interpreted. Although URLs do not produce clickable links, a wikilink with [[Special:Diff/]] can make clickable [[Help:Diff#Internal links|diffs]], and [[Special:PermaLink/]] can make [[Help:Permanent link|permanent links]]. <code><nowiki>~~~~</nowiki></code> has no effect, so do not [[Wikipedia:Signatures|sign]] edit summaries.
* You can [[WP:MENTION|mention]] a user in your edit summary and they will receive a notification.

===Places where the edit summary appears===
The edit summary appears in black italics in the following places:
* [[Help:Page history|Page history]]&nbsp;– list of changes to the page you edited
* [[Help:User contributions|User contributions]]&nbsp;– list of all your edits
* [[Help:Watching pages|Watchlist]]<ref group="note">Use the enhanced watchlist to see all recent changes in the watched pages, not just the last change in each page.</ref>&nbsp;– list of recent changes to watched pages ([[Help: Logging in|logged-in]] users only)
* [[Help:Diff|Diff page]]&nbsp;– shows the difference between two edits
* [[Help:Recent changes|Recent changes]]&nbsp;– list of all recent edits
* [[Wikipedia:IRC|Wikipedia IRC channels]]&nbsp;– real-time list of all edits
* [[Help:Related changes|Related changes]]&nbsp;– list of recent changes to pages linked to the page you edited
* [[Special:NewPages|List of new pages]]&nbsp;– shows the edit summary of the creation.

====Notes====
{{reflist|group="note"}}

===Section editing===
When adding a new section to a discussion page with the "new section" button, the section title is used as the edit summary. When [[Help:Section#Section editing|editing an existing section]], the section title is inserted at the beginning of the edit summary, enclosed with /* and */ marks, for example /* External links */. Details of the edit should be added after this text.

When viewing such an edit summary, the section name will appear in blue, with a small arrow next to it: <span class="autocomment">[[#Foo|''→External links'']]</span>. Click the arrow or section name to view the section (if the section no longer exists, the link will simply take you to the top of the page).

If you create a new section before or after an existing section by clicking a section "''edit''{{-"}} link, delete the text between /* and */ marks (or change it to the new section title) to avoid confusion.<ref>It is possible to manually include links to multiple sections using the /* */ syntax&nbsp;– this may be useful when editing several sections at once.

The edit summary:

: {{Inputbox|/* Foo */ test /* Bar */ test}}

should be rendered as:

: <span class="comment"><span class="autocomment">[[#Foo|→Foo]]:</span> test <span class="autocomment">[[#Bar|→Bar]]:</span> test</span>.

See [{{fullurl:Help:Edit_summary|diff=384901084&oldid=384900839}} this edit].</ref>

{{reflist}}

===Automatic summaries===
{{main|Help:Automatic edit summaries}}
In certain circumstances, an automatic summary is generated when an edit is published without one. This is slightly different from the summary added when editing a section, as that can be modified by the user before saving.

With the exception of the automatic summary when creating a redirect, which usually says all that needs to be said, these are not a substitute for a proper edit summary&nbsp;– you should always leave a meaningful summary, even in the above cases. They are, however, useful in providing some context for edits made by inexperienced users who are not aware of the importance of edit summaries, and for spotting vandalism.

When starting a new thread on a [[WP:TALKPAGE|talk page]] by using the "New section" tab, the text you type into the "subject/headline" field becomes both the heading of your discussion topic, and the edit summary for that edit.

====Tags====
{{see also|Wikipedia:Tags}}
Tags (i.e., edit tags) are brief messages that the software automatically places next to certain edits in [[Help:Page history|histories]], [[m:Help:Recent changes|recent changes]] and other special pages. They are implemented by the [[WP:FILTER|edit filter]] to help assist vandalism patrollers and other page watchers. They cannot be added or removed manually.

==Notes for experienced users==
* There are [[:Category:Standardised user warning templates|standard templates]] for warning editors who delete content without providing an edit summary: {{tl|Uw-delete1}} (which assumes good faith) and {{tl|Uw-delete2}} (which doesn't). {{tl|Uw-editsummary}} is available for notifying users who have not provided an edit summary for other types of edit. These are available via [[WP:TWINKLE|Twinkle]].
* When editors [[WP:RfA|stand for Adminship]], their RfA pages include statistics about how often they have provided edit summaries in the past.
* A user's edit summary usage can be checked with [https://xtools.wmflabs.org/editsummary this tool].{{sup|([https://xtools.wmflabs.org/editsummary/en.wikipedia.org/Jimbo_Wales example])}}

If you are a [[Wikipedia:Tutorial/Registration|registered user]] and want to show your commitment to always leaving edit summaries, which will remind other users of the importance of doing so, you can use any of the following userboxes: {{Tlx|User edit summary}}, {{Temt|User:Marek69/edit summary template}}, {{Temt|User:Ritchie333/Userbox ES}} or {{tlx|Use Edit Summaries}}.
{{Align|right|{{User:Marek69/edit summary template}}}}
{{Align|right|{{User:Ritchie333/Userbox ES}}}}
{{Align|right|{{User edit summary}}}}
{{Align|right|{{Template:Use Edit Summaries}}}}
{{clear}}

===The 500-character limit===
The limit of 500 characters is an approximation. The actual limit is 500 [[Unicode]] [[codepoint]]s. Most characters occupy one codepoint, but some characters like those with [[diacritic]]s or [[emoji]]s may consist of more than one codepoint. The limit of 500 codepoints includes the section title marker (and the associated <code>/*&nbsp;&nbsp;*/</code>) and also any Wiki markup that may be present. 

For editors who have JavaScript enabled, there is a script included with the page that monitors the codepoint-length of the summary and prevents entering summaries longer than 500 codepoints (both in "Edit source" and in Visual editor). A count is displayed at the right-hand end of the text entry field, showing the number of unused codepoints. When JavaScript is disabled, this safeguard can't function and the only protection is the browser's limit of 500 characters, which may overflow the 500-codepoint limit as a result of any characters that are represented by more than one codepoint.

When the edit is done by a bot, through an external tool (such as [[WP:AWB]]) or through some user script or gadget, it's the responsibility of the tool or script to safeguard against overflowing this limit. In any situation where more than 500 codepoints are entered for the edit summary, the summary is truncated to 500 codepoints when the page is published.

== See also ==
{{Wikipedia glossary}}
* [[Wikipedia:Edit summary legend]] – commonly used edit summary abbreviations
* [[Wikipedia:Added or removed characters]]
* [[Wikipedia:Red flags in edit summaries]]
* [[Wikipedia:What does 'per' mean?]]
* [[Help:Deletion summary]]

==External links==
*[https://tools.wmflabs.org/jackbot/snottywong/commentsearch.html User Edit Summary Search] This tool will search through a user's edit summaries and return edits with a partial match. 

{{Help navigation}}

[[Category:Wikipedia editing]]
[[Category:Wikipedia edit window help]]