This is a documentation subpage for Template:Under construction. It may contain usage information, categories and other content that is not part of the original template page.

Any breaking changes to this template, including moving it or nominating it for deletion, must be communicated in advance to Twinkle's users and maintainers at Wikipedia talk:Twinkle. The standard installation of Twinkle relies on this template. Thank you.

This template is for articles actively undergoing construction, that is, continuous improvements spread out over hours or days or even longer. The intent is to signal to other editors that while they may edit the article, they should be a little more forgiving than usual. Paragraphs might be moved around, images might be placed slightly off, and the like. Please do not revert any mistakes you see on sight - this template signals that another editor (or set of editors) is actively developing the article, and you might help better by waiting until the construction period is over (and the template is removed) before you point out or revert any mistakes you see.

A "contributor note box" may be added with a custom message below the template using the |comment= parameter.

Articles tagged with this template are automatically added to the category Category:Pages actively undergoing construction. Add the parameter |placedby= (followed by your user name; do not insert a full signature) to make it easy for people to contact the person who placed the template. If a page using this template has not been edited in 8 days, a bot will automatically remove the template.

If used on a non-article page (such as a user page) which is not yet ready for use, type {{Under construction|notready=true}}. That will produce the following:

This template page or section is undergoing significant expansion or restructuring, and is not yet ready for use. You are welcome to assist in its construction by editing it as well. If this template page has not been edited in several days, please remove this template. If you are actively editing this article or section, you can replace this template with {{in use|5 minutes}}. This template was last edited by Chaotic Enby (talk | contribs) 20 days ago. (Update timer)

As this template is used in multiple namespaces it uses {{mbox}}, which will automatically detect individual namespace usage and adapt appropriate styling accordingly.

If the article is actively undergoing a major edit, where another editor is in the middle of making several edits during a much shorter time-span (no more than a few hours), and you are asked to not edit the article at all for that short period of time, please use {{In use}}.

In general, this template should not be used for new articles with little or no content. Instead, the article should be developed as a draft or userspace draft so that it has reasonable content when it is copied into mainspace. Use {{In creation}} instead of this template when you create a brand new article and plan on making multiple edits as part of your initial build-up of content.

If you see this template on a page with no edits during the past seven days, you can safely assume the editor forgot to remove it. If the template says "...and notify the editor who placed it" this means the editor used the |notify=y parameter to indicate that they would appreciate it if you posted a message on their talk page when you remove the Under construction template.

{{Under construction |placedby= |section= |nosection= |nocat= |notready= |comment= |category= |altimage= |notify= }}

• altimage – provide an alternate image for the template. Should be a complete file tag including the double square brackets, e.g. [[File:Under_construction_icon-orange.svg|64px]]
• category – a custom category (must be prefixed with the "Category:" namespace identifier and enclosed in double square brackets) into which the page will be placed. If omitted, the page is placed by default in Category:Pages actively undergoing construction. However the page will not be placed into a category if the page is in the "User:" or "User talk:" namespaces.
• comment – free-form text. If present, the text "Contributor note:" is shown in a separate box followed by the content of |comment=.
• nocat – set to true (e.g. |nocat=true) to prevent the page from being placed into a category (either the default Category:Pages actively undergoing construction or the custom category if |category= is also supplied).
• notready – value is immaterial, but if present, and not blank (e.g. |notready=yes), adds the text ", and is not yet ready for use" following the word "restructuring".
• nosection – value is immaterial, but if present, and not blank (e.g. |nosection=yes), removes the phrase "or section", i.e. makes the message apply to the entire page
• placedby – user name of the person placing the template. Do not use a full talk page signature. If the parameter value does not start with a letter, the template assumes a signature is given, and won't apply the {{User}} template to beautify the user name.
• section – value is immaterial, but if present, and not blank (e.g. |section=yes), removes the phrase "article or", i.e. makes the message apply only to a section.
• subsection – value is immaterial, but if present, and not blank (e.g. |subsection=yes), removes the phrase "article or", i.e. makes the message apply only to a subsection.
• notify – value is immaterial, but if present, and not blank (e.g. |notify=yes), adds a note that the placing editor asks to be notified (on their talk page) if template is removed.

• {{In creation}} to use this template when multiple edits are being made to add content immediately after creating the article
• {{In use}}, for articles actively undergoing a major edit for a short while to list them in Category:Pages actively undergoing a major edit
• {{Under discussion}}, for a non main page undergoing active discussion on its talk page
• {{recently revised}}, if you are unsure about your revision/major changes and want a second opinion
• {{Deletion under review}}, to prevent deletion nomination until the review process is complete

• Wikipedia:Deletion of newly created pages, regarding preventing pages from getting deleted while they are brand new.