| Note: When you edit this page, you agree to release your contribution under theCC0. SeePublic Domain Help Pages for more info. |
Anedit summary is a short message you leave for others when you make changes to a page.Examples of common edit summaries include "Fixed a typo" or "Added a newsection".Using edit summaries helps other users understand your edits without having to dig into the details.It's optional but super helpful for keeping everyone on the same page.If a copyright infringement is found, it also keeps authorship information after a significant revision deletion.[1]
Prompt me when entering a blank edit summary (or the default undo summary) (underEditing section) can be useful to ensure you don't forget to leave one.
The page layout for entering an edit summary typically includes the following elements:
Summary(?): input field - A text box where you can enter a brief description of the changes you made. This field is essential for providing context in the page history.This is aminor edit checkbox - Positioned near the edit summary box, this checkbox allows you to flag the edit as minor, indicating that the changes are small or not significant.Watch this page checkbox - Another checkbox, this option lets you add the page to yourwatchlist, allowing you to receive notifications for future edits. The duration you'd like to watch the page for can be set using the drop-down menu namedWatchlist time period:. It's important because a user may comment on your edit after you publish your changes.Publish changes button - Positioned below the edit summary input field, this button finalizes the edit. Users should ensure their summary accurately reflects the changes before clicking.Show preview button - This shows a rendered preview of the page's content and also a rendered preview of the edit summary. This preview appears just below the edit summary input field.Show changes button - This has nothing to do with the edit summary. It displays a comparison between the old and new content changes that will be applied on the page.The edit summary box can hold up to 500 characters.If you try to add more, only the first 500 characters will be saved.
One editing tip is that if you make a mistake in the summary, you can do adummy edit (like adding a space) to fix it.
What works:
/* Section Name */, which will show a clickable arrow pointing to that section when you click onShow preview.What doesn't work:
Handling section links:
Working around URL issues:
%28 in it which represents a special character(, you can replace it with the actual character.Discussion tools feature+ sign allows you to add a new section. TheSubject box becomes both the section title and the edit summary.When you save an edit without providing a summary, an automatic summary is sometimes generated for you.Unlike the summary that appears when editing a section—which you can modify before saving, this automatic summary is created entirely by the system and can't be changed.
| Situation | Page | Automatic summary text |
|---|---|---|
| Large-scale edits to pages | ||
| Removing all text from a page | MediaWiki:Autosumm-blank | Blanked the page |
| Removing most texts from a page or editing a short page ( $1 is replaced with the page text) | MediaWiki:Autosumm-replace | Replaced content with "$1" |
| Creation of pages | ||
Creating a new page ($1 is replaced with the page text) | MediaWiki:Autosumm-new | Created page with "$1" |
| Creating a new page without content | MediaWiki:Autosumm-newblank | Created blank page |
| Changes to redirects | ||
| Creating or replacing a page containing a redirect ( $1 is replaced with the target of the redirect) | MediaWiki:Autoredircomment | Redirected page to$1 |
| Changing the target of a redirect ( $1 is replaced with the previous target of the redirect;$2 is replaced with the new target of the redirect) | MediaWiki:Autosumm-changed-redirect-target | Changed redirect target from$1 to$2 |
| Removing a redirect ( $1 is replaced with the target of the redirect) | MediaWiki:Autosumm-removed-redirect | Removed redirect to$1 |
While automatic summaries, such as those created during redirects, often provide sufficient information, they are not a substitute for a proper edit summary.Always add a clear and concise summary to give context to your edits.This practice is particularly helpful for:
There is R&D into automatic generation of edit summaries.[2]
Some features, particularly those related to Wikidata, use multilingual automatic summaries through MediaWiki's autocomment functionality.These summaries appear in the viewer's language, adapting to their settings.In tools that show the raw edit summary, these may appear as a code or key, such as/*wbsetsitelink-add:1, which is used to manage internationalization (i18n).
The edit summary appears in various places across the platform inblack italics.Here's where you can find it:
Permanent locations:
Temporary locations:
Additionally, the edit summary is included in the email notifications you receive if you've enabled email alerts for edits.
When you upload an image, you can include an upload summary.This summary has several important functions:
The upload summary can be over 600 characters long.Note that in the upload log, the last part of the summary may be cut off if it exceeds 600 characters (includinguploaded "filename").
MediaWiki's built-in search function doesn't include edit summaries, and these summaries aren't indexed by external search engines.
There is an unofficial external tool for filtering by edit summaries in Wikimedia projects at Wikimedia Labs:edit summary search.Also, hashtags (like #tag) can be searched athttps://hashtags.wmflabs.org.A third way to search them is using Quarry and thecomment_text field.(Example query that shows a user's created categories on Commons)
When you perform protection or move actions on a page, these actions are recorded in the page history.Here's what you need to know: