Template messages (maintenance tags, cleanup tags, cleanup messages) may be added to articles needing cleanup. Their purposes are to foster improvement of the encyclopedia by alerting editors to changes that need to be made. Cleanup tags are meant to be temporary notices that lead to an effort to fix the problem, not a permanent badge of shame to show that you disagree with an article, or a method of warning readers about an article.

This is an information page. It is not one of Wikipedia's policies or guidelines; rather, its purpose is to explain certain aspects of Wikipedia's norms, customs, technicalities, or practices. It may reflect differing levels of consensus and vetting.

Shortcuts WP:TC WP:TMC WP:CLEANUPTAG WP:CTAGS

This page in a nutshell: Add template messages to inform readers and editors of specific problems with articles or sections, but do not use them as a badge of shame.

Unless otherwise noted, cleanup messages should be placed at the top of the page, before other templates, images, or infoboxes, but after hatnotes (see Wikipedia:Hatnote § Placement). Cleanup messages should be placed directly on the article or file, not on its talk page. Certain tags can be placed at the beginning of an individual section, and others can be placed within the text itself (inline).

A date parameter is added by a bot, or you can add it yourself with |date=April 2024.

Before you tag an article, please remember the following:

Don't tag an article if you can easily and confidently fix the problem.

The goal is an improved article, not a tagged article.

Do some research to attempt to solve the problem before tagging.

Don't put the burden of doing so on another editor if you are capable of fixing the problem yourself with a simple search or consulting a reference work.

Don't do "drive-by" tagging.

Tags must be accompanied by either a comment on the article's talk page explaining the problem and beginning a discussion on how to fix it or, for simpler and more obvious problems, a remark using the reason parameter (available in all templates, regardless of whether it appears in the documentation) as shown below. At the very least, tagging editors must be willing to follow through with substantive discussion.

Don't do "drive-by" de-tagging.

Likewise, please provide a similar rationale for removing a template, unless your preceding edits have clearly fixed the announced problem. See also when not to remove a template.

Don't insert tags that are similar or redundant.

For example, most articles that read like essays have an inappropriate tone, and in fact they end up being automatically grouped in the same category, so it is unnecessary to tag with both {{tone}} and {{essay-like}}.

If an article has many problems, tag only the highest priority issues.

A lengthy list is often less helpful than a shorter one. (See also: Wikipedia:Tag bombing and Wikipedia:Tagging pages for problems § Over-tagging)

Don't add tags for trivial or minor problems, especially if an article needs a lot of work.

For example, there is little point in noting grammatical problems for a section that needs to be completely re-written to comply with content policies. Focus on the biggest one, two, or three problems.

Before placing templates on a page it is worthwhile to cast a critical eye over the page to determine whether indeed it should be included in Wikipedia. Some articles can be tagged for speedy deletion or nominated for a deletion discussion at Wikipedia:Articles for deletion.

On pages that have received little attention from editors or readers, cleanup templates can be used as a way to call attention to problems that need to be addressed by editors. Editors who want to help address these problems should look through the various cleanup categories such as maintenance and articles with content issues and try to address the problems so that the templates can be removed. Editors who frequently tag articles should also address the backlogs.

On pages that are being edited by a number of users, cleanup templates are used to inform readers and editors of ongoing discussions and attempts to fix the problems on the page. Such templates can be used to attract uninvolved users to discussions and cleanup efforts, and they can also serve as a warning to casual readers that the article may have problems and be subject to noticeable changes. In general, an editor who places a template message to indicate a problem like this should explain their rationale fully on the talk page of the article. If the consensus of the other editors is that there is a problem or an editorial dispute that deserves such a clean-up template, then the editors should work to fix the problem as quickly and cleanly as possible so the template message can be removed. If the consensus is that there is no problem, then the message can be removed immediately. For heavily monitored articles, please do not add or remove template messages of this sort without using the talk page.

Many of these cleanup tags require you to place |article as the first parameter when you use the tag at the top of an article. When you want the template to refer to just one section, however, you replace |article with |section (where the | is a pipe key | found on most keyboards as a shift-backslash ⇧ Shift+\. See the specific template below to determine if such "section use" is supported and appropriate.

If too many tags are put at the top of an article, the article can become eclipsed by the tags, especially with short or stub articles. Consider consolidating the tags into {{multiple issues}}.