An edit summary is a brief explanation of an edit to a Wikipedia page. Summaries help other editors by (a) providing a reason for the edit, (b) saving the time to open up the edit to find out what it's all about, and (c) providing information about the edit on diff pages and lists of changes (such as page histories and watchlists). According to the consensus policy, in general, edits should be explained.
Always provide an edit summary
According to the consensus policy, all edits should be explained (unless the reason for them is obvious)—either by clear edit summaries, or by discussion on the associated talk page. It is a good practice to provide a meaningful summary for every edit, especially when reverting (undoing) the actions of other editors or deleting existing text; otherwise, people may question your motives for the edit. In appropriate circumstances, a summary can be quite brief ("ce" and "rvv" for example).
Accurate summaries help other contributors decide whether they want to review an edit, and to understand the change should they choose to review it. Edits without edit summaries are more likely to be reverted incorrectly because they provide no explanation or rationale for the change. Editors should not revert an otherwise good edit because of a missing or confusing edit summary; good editors may simply have forgotten, or a confusing edit summary may have been the result of an autofill mishap. (If the edit summary itself violates privacy or other policies, see the Fixing section below.) However, realistically, when a major edit (e.g., addition or deletion of a substantial amount of article text, or a substantial rewrite) doesn't have an edit summary, some busy editors might not assume good faith and revert the change without evaluating it properly. Providing an edit summary helps prevent that kind of error.
Summaries are less important for 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, registered editors can select "Prompt me when entering a blank edit summary" on the Editing tab of the user preferences.
How to write an edit summary
- 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. If you believe a Wikipedia policy or guideline justifies the change then you may include a link to it in 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 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 talk page to give more information, and include "see talk" or "see discussion page" in the edit summary.
- If you are 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 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. To add a summary, type in the text entry field in the Edit summary box located near the bottom of the Editing page. The box looks like this:
Edit summary (Briefly describe your changes)
This is a Watch this page
By publishing changes, you agree to the Terms of Use, and you irrevocably agree to release your contribution under the CC BY-SA 4.0 License and the GFDL. You agree that a hyperlink or URL is sufficient attribution under the Creative Commons license.
Cancel
What to avoid in edit summaries
- 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 explaining every detail, writing essays about "the truth", or long-winded 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 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 personal attack.
- Avoid incivility. Snide comments, personal remarks about editors, and other aggressive edit summaries are explicit edit-summary "don'ts" of the Wikipedia Civility policy.
Warning: be careful of what you write in edit summaries. Inappropriate edit summaries may be used as evidence against you in behavioral complaints. This applies particularly to uncivil and deliberately misleading edit summaries.