|This page documents an official policy on Scratchpad.|
It has wide acceptance among editors and is considered a standard that everyone should follow. Except for minor edits, please make use of the discussion page to propose changes to this policy.
At Scratchpad, reverting means undoing the effects of one or more edits, which normally results in the page being restored to a version that existed sometime previously. More broadly, reverting may also refer to any action that in whole or in part reverses the actions of other editors.
This page contains technical information about making reverts. It should be borne in mind, however, that reverting good-faith actions of other editors — as opposed to vandalism — is considered disruptive when done to excess, and can even lead to the reverter being blocked from editing.
In some cases (for example: if a vandal added or removed text, and unrelated constructive edits have been made since), the easiest way to undo past edits may simply be to edit the current page, deleting wrongly added text or restoring wrongly deleted text (this can be copied and pasted from a past version of the page). However, it may be more convenient to restore a particular old version of the page from prior to the changes you wish to revert. To do this:
- To display the page history (see also: m:Help:Page history), do one of the following:
- In Oasis, select history from the pulldown edit menu at the top of the page
- In Monobook, click the history tab at the top of the page
- Click the time and date of the earlier version to which you wish to revert. You will see a phrase similar to: “This is an old revision of this page, as edited by ***.***.***.*** (Talk) at 15:47, January 24, 2018. It may differ significantly from the current revision.”
- Important: In the case of vandalism, take the time to make sure that you are reverting to the last version without the vandalism; there may be multiple consecutive vandal edits or they may be interspersed between constructive edits.
- Click edit as you normally would to edit a page. (Above the edit box, you will see a warning similar to: You are editing an old revision of this page. If you save it, any changes made since then will be removed.)
- Complete the edit summary field (the abbreviation rv can be used to stand for revert; the edit summary rvv means reverting vandalism).
- Publish the page.
- If constructive edits had been made after those that you wished to revert, return to the page history to find those edits, and re-input them manually if reasonably possible.
The MediaWiki software sometimes enables editors to easily revert (or “undo”) a single edit from the history of a page, without simultaneously undoing all constructive changes that have been made since.
To do this, view the page history (see also: m:Help:Page history) or the diff for the edit, then click on undo next to the edit in question. The software will attempt to create an edit page with a version of the article in which the undesirable edit has been removed, but all later edits are retained. There is a default edit summary, but this can be modified before saving.
It is also possible to undo several consecutive edits, even if they conflict among themselves: view the diff to be removed (by selecting the two extreme revisions in the history and clicking compare selected revisions), and click the undo link.
This feature removes the need to manually re-input useful changes that were made after the edit which is being reverted. However, it will fail if undoing the edit would conflict with later edits. For example, if edit 1000 adds a paragraph and edit 1005 modifies that paragraph, it will be impossible to automatically undo edit 1000. In such an instance, you must determine how to resolve the problem manually.
- appear only next to the top edit
- revert all top consequent edits made by last editor
- work immediately, without the intermediate confirmation diff page
- add automatic edit summary: m Reverted edits by Example User (talk) to last version by Example2, marking the edit as minor
Rollback links appear on the user contributions pages, user watchlists, history pages, and diff pages. Note that in the last case, rollback links can be misleading, since reversion is not necessarily to the old version shown (the diff page may show the combined result of edits, including some by other editors or only part of the edits the rollback button would revert). To see the changes the rollback button will revert, view the specific diff that compares the last version from the last editor with the last version from the previous editor.
Rollback works much quicker than undo, since it:
- allows reverting without even looking at the list of revisions or diff
- does not require loading an edit page and sending the wikitext back to the server
- does not require a click of the Publish button
On the other hand, it is not as versatile as undo, since it does not allow specification of which edits have to be undone. One may want to revert more, or less, edits than the rollback does, or edits which do not include the last edit. It also does not allow adding an explanation to the automatic edit summary.
Rolling back a good-faith edit, without explanation, may be misinterpreted as “I think your edit was no better than vandalism and reverting it doesn’t need an explanation.” Some editors are sensitive to such perceived slights. If you use the rollback feature other than for vandalism (for example, because undo is impractical due to the large page size), it is courteous to leave an explanation on the article’s talk page or on the talk page of the user, whose edit(s) you have reverted.
If someone else edited or rolled back the page before you clicked the rollback link, or if there was no previous editor, you will get an error message.
In cases of flood vandalism, Administrators may choose to hide vandalism from recent changes. To do this, add &bot=1 to the end of the url used to access a user’s contributions. For example:
When the rollback links on the contributions list are clicked, the revert and the original edit that you are reverting will both be hidden from recent changes, unless you click the bots link to set hidebots=0.
- The edits remain in the database and are not removed, but they no longer flood recent changes.
The aim of this feature is to reduce the annoyance factor of a flood vandal, with relatively little effort.
Changing edit summary
It is also possible to use rollback with a manually entered, explanatory edit summary (instead of the automatically generated, default, or standard, generic edit summary). To do this:
- copy the URL of the rollback link
- paste it into your browser’s address bar
&summary=to the end of the URL, followed by your desired summary
In order to revert an image to a previous uploaded version, go to the image page and click on File history. The File history section of the image displays the full history of edits to the image along with a thumbnail of each version. Logged-in users can see a revert link for every version other than the current version. Clicking on a version’s revert link makes that version the current version.
Edit summaries, always a good practice, are particularly important when reverting. Provide a valid and informative explanation including, if possible, a link to the Scratchpad principle you believe justifies the reversion. Try to remain available for dialogue, especially in the half-day or so after reverting.
A reversion is a complete rejection of the work of another editor and if the reversion is not adequately supported then the reverted editor may find it difficult to assume good faith. This is one of the most common causes of an edit war. A substantive explanation also promotes consensus by alerting the reverted editor to the problem with the original edit. The reverted editor may then be able to revise the edit to correct the perceived problem. The result will be an improved article, a more knowledgeable editor, and greater harmony.
In addition to helping the reverted editor, providing information regarding the reversion will help other editors by letting them know whether – or not – they need to even view the reverted version, such as in the case of blanking a page. Explaining reverts also helps users who check edit histories to determine the extent to which the information in the article is reliable or current.
If your reasons for reverting are too complex to explain in an edit summary, leave a note on the article’s talk page. It is sometimes best to leave a note on the talk page first — then revert — rather than the other way around; thus giving the other editor a chance to agree with you and revise their edit appropriately. Conversely, if another editor reverts your change without any apparent explanation, you may wish to wait a few minutes to see if they explain their actions on the article’s, or your user’s, talk page.
| This page uses content from Wikipedia. The original article was at Help:Reverting.|
The list of authors can be seen in the
As with Scratchpad, the text of Wikipedia is available under the Creative Commons Licence.