Help:Maintenance template removal

From PeoplesPedia
Jump to: navigation, search

Many Wikipedia pages display maintenance templates that address problems with the topic or content of the page. You may have arrived at this help page after you clicked on a link in just such a maintenance template, that said "Learn how and when to remove this template message".

Maintenance templates are added and removed by volunteers. This help page explains the process for examining and removing such templates.


Maintenance templates (or "tags") are never removed automatically. Even if you fix the issue(s) described in a maintenance template, the tag will remain in the article until you or someone else manually removes it. The mechanics of removal are usually as simple as clicking "Edit" at the top of the page or in the section involved (if you're not already in edit mode), removing the code that produces the display of the template, leaving an edit summary and saving the page.

It is not okay to remove maintenance templates until the issue flagged by the template is remedied first—that is, only once the maintenance tag is no longer valid, unless it truly did not belong in the first place.

Wikipedia works because of the efforts of volunteers just like you, making bold edits to help build this encyclopedia. Fixing problems and then removing maintenance templates when you're done is important in that effort.

Addressing the flagged problem

We don't know which maintenance tag brought you to this page, and thus what specific problem needs attention. However, every maintenance template contains links to help pages, policies, guidelines or other relevant pages that provide information on the problem the template was placed to flag. You will also find guidance on some of the more common templates below.

Many common templates address problems with article citations and references, or their lack—because reliable sourcing is the lifeblood of Wikipedia articles and at the core of all of Wikipedia's content policies and guidelines, such as notability, verifiability, neutral point of view, and no original research. But a host of other issues may be flagged, including tone and style of writing, structure and formatting, lack of links to other articles or from other articles to the article at issue, compliance with Wikipedia's manual of style and the lack of a lead section.

Making sure that the issue has been fixed is the condition you need to fulfill before removing the template. That does require some effort on your part—to understand both the problem and how to solve it.

An example

If the issue flagged by the maintenance template is that the article contains no references, then the template used might be {{Unreferenced}} – typically placed by the code you would see when wikitext (source) editing: {{Unreferenced|date=June 2021}}.

It is important to understand that what you see when reading an article, and what you see when editing it, is different. Thus, the above code, only seen when doing source editing, results in the display of the 'called' template below:


This template contains a number of links, indicated by the words and phrases in blue. Three of these links are to pages that, when explored, provide context and resources for you to understand why the template was placed on the page, and how to address the issue of the article being unreferenced:

Whatever maintenance tag brought you to this help page should likewise contain relevant explanatory links addressed to whatever its issue is. Read these explanatory and contextual pages to learn about the problem and what it is you need to do to take care of it. Again, some of the more common maintenance templates seen are addressed in the specific template guidance section below.

When to remove

Error: no shortcuts were specified and the |msg= parameter was not set. Maintenance templates are not meant to be in articles permanently. Any user without a conflict of interest may remove a maintenance template in any of the following circumstances:

  1. When the issue has been adequately addressed;
  2. Upon determining that the issue has been resolved (perhaps by someone else);
  3. If it reasonably appears that the template did not belong when placed or was added in error. Discussing the matter with the original placer of the template is advised, though if the user is no longer active this becomes moot. In any case, if the issue appears contentious, seek consensus on the talk page;
  4. When there is consensus on the talk page (or elsewhere) as to how to address the flagged issue. (It is best to note the location of the consensus in the edit summary accompanying your removal, ideally with a link to the location);
  5. When it can reasonably be concluded that the template is no longer relevant, such as a {{Current}} template appearing in an article that no longer documents a current event;
  6. If the maintenance template is of a type that requires support but is not fully supported. Some neutrality-related templates, such as {{COI}} (associated with the conflict of interest guideline) and {{POV}} (associated with the neutral point of view policy), strongly recommend that the tagging editor initiate a discussion (generally on the article's talk page), to support the placement of the tag. If the tagging editor failed to do so, or the discussion is dormant, the template can be removed;
  7. There is currently no consensus for age-related removal of maintenance templates, with the exception of POV-related templates as addressed immediately above. In this regard, some templates relate to matters that are binary and unambiguous—the problem the maintenance template flags is plainly required for a proper article under Wikipedia's policies and guidelines, and therefore persists until addressed (e.g., the lack of any citations). As with the POV exception, age alone may be relevant where a lack of edits or of discussion addressed to the issue may be interpreted as a form of "silent consensus", that the issue isn't worth fixing. This invariably involves matters implicating an exercise of judgement and subjective elements;
  8. Lastly, there are times when a person attempting to address a maintenance template that flags some fundamental matter may find that the issue cannot actually be addressed. For example, if an article is flagged as lacking citations to reliable, secondary sources, written by third-parties to the topic, and a user seeing the maintenance templates discovers that such sources appear not to exist, that usually means the article should be deleted. In such cases, it is not so much that the template does not belong and should be removed, but rather that flagging the page for maintenance will never address the more critical issue that the page itself does not belong on Wikipedia at all.

When not to remove

Error: no shortcuts were specified and the |msg= parameter was not set. You should not remove maintenance templates if any of the following apply:

  1. The issue has not yet been resolved;
  2. There is ongoing activity or discussion related to the template issue (with the exception of POV-related templates);
  3. You do not understand the issues raised by the template;
  4. You have been paid to edit the article or have some other conflict of interest.


Have you carefully read the help pages and have thoroughly fixed the problem? Or have you made a considered decision that the template is not, or is no longer, applicable? Great! Now, to remove the maintenance template:

  1. Either click on "edit" or "edit source" at the top of the page, or if the maintenance template is not at the top but somewhere in the body of the article, you might instead use a section edit link;
  2. If you are editing wikitext ("source" editing): Delete the template code. The template code you see in this edit mode will usually be in the following form, as in the example above: {{Name of template|date=Month Year}}. If you are editing using VisualEditor: Click on the template (tag), which will then turn blue. Press the "Delete" key on the template box dialogue which will appear;
  3. Leave a descriptive edit summary, e.g., "Removed [insert the name of template] because I have fixed the issue;"
  4. Click Save changes.

That's it. Thank you!

Changing a template

Problems flagged by some templates may imply secondary problems that will still exist after you take care of the main issue. In such cases, it may be more appropriate to switch the template to another applicable one following your edits, rather than just removing it. The reasoning behind the change in templates should be addressed in the edit summary.

Case in point is the {{Unreferenced}} template example used above. It is placed on pages with no references. Thus, adding just one suitable reference renders that maintenance template inapplicable. However, that change does not take care of the overarching issue of poor sourcing. In this example, a change to a different template may be appropriate, depending on the type, quality, depth and manner of sourcing added to fix the issue, such as {{refimprove}}, {{No footnotes}}, {{Primary sources}}, or one of the many others listed at Wikipedia:Template messages/Sources of articles.

Conversely, some templates flag highly discrete issues where there is no need to consider a switch to another template. For example, if an article is "orphaned" – no other articles in the main article namespace link to it – then once that is taken care of (by the addition of links to it from other articles), the issue is gone entirely and the tag's removal is unambiguous.

When a flagged issue has been addressed in parts of an article, but remains in discrete sections, clarity may be served by replacing the template with a section variant, or by use of inline cleanup tags, if such versions of the template exist.

In some cases, it may be helpful to request review of a maintenance template's removal or proposed removal with the editor who initially added it to the article at issue.

Specific template guidance

This section provides guidance on how to address some of the more common specific templates that may have brought you to this help page. More detailed information about the templates can be found by following the links to the templates themselves.

Click "show" at the right to display the instructions.

Researching the tagged issue

As noted previously, most templates contain links to guidance pages. Additionally, many templates have documentation that provides more information about the template's flagged issue, which is displayed when you visit the template page itself.

To access the template and thereby see its documentation, type into the search field Template:, followed by the name of the template, seen when you view its placement in the Edit interface (typically found in the first lines of the article). The first "parameter" is the name of the template.

For example, if you found this in the Edit interface, {{Unreferenced|date=June 2021}}, then you would visit the template itself by searching for Template:Unreferenced. The accompanying documentation for all maintenance templates, if it exists, can be located in this way.

Still need help?

If you've read through this page and are still confused about what needs to be done to fix an issue on a page and remove a maintenance template, try asking at the Teahouse, a page designed for new users to ask questions. Alternatively, you could try the more general Help desk, or seek live assistance at the IRC channel: #wikipedia-en-help.

See also