Help:Tags
A tag (also referred to as a change tag or revision tag) is an annotation associated with an edit or log entry. They are displayed in various locations when referring to revisions, such as in the page history, diffs, recent changes and other places.
Tag information
To view a list of all tags on your wiki, visit Special:Tags. A table lists all tags that are defined, and/or applied to at least one revision or log entry.
The meaning of each column is as follows:
- Tag name
- The internal code name of the tag. This cannot be modified.
- Appearance on change lists
- The way the tag will appear in change lists (page histories, user contributions, watchlists, logs, diffs, etc). This text is fetched from the system message
MediaWiki:Tag-<tag name>
; if this message does not exist, the internal tag name will be shown in change lists. - Administrators (those with the
editinterface
user right) will see an "edit" link to modify theMediaWiki:Tag-<tag name>
page. Set the contents of this page to hyphen-minus (-
) to hide the tag from all change lists. - Full description of meaning
- A description of the tag's purpose, only displayed on Special:Tags and nowhere else. This text is fetched from the system message
MediaWiki:Tag-<tag name>-description
. - Administrators (those with the
editinterface
user right) will see an "edit" link to modify theMediaWiki:Tag-<tag name>-description
page. - Source
- Whether the tag is defined by the software ("Defined by the software"), users on the wiki ("Applied manually by users and bots"), or nobody ("No longer in use").
- Active?
- Whether the tag is still in active use. For software-defined tags, this value is determined by the software. For manually-applied tags, it is set by wiki administrators (see section Activating or deactivating a tag).
- Tagged changes
- Shows how many changes (revisions or log entries) the tag is applied to. The link goes to Special:RecentChanges with a tag filter applied, which only shows recent uses of the tag.
- Actions
- This column only appears if you have the rights to perform tag management tasks. See Tag management below for an explanation.
Automatically applied tags
Adding or removing tags from a revision or log entry
MediaWiki version: | ≥ 1.25 |
Tag management
MediaWiki version: | ≥ 1.25 |
Users with the managechangetags
user right (administrators by default) can use the Special:Tags special page to create, delete, activate and deactivate tags.
Creating a tag
You may create a new tag which will be applied manually by users. The name of the tag must satisfy the following criteria:
- It must not contain the comma (
,
) or forward slash (/
) characters. - It must not contain characters that are prohibited in page titles (for example,
[
). - It must not be reserved by the software.
To do this, use the form at the top of Special:Tags. (If you do not see the form, you do not have permission to create tags.) The reason you provide will be entered into the tag management log.
Deleting a tag
If a tag is no longer wanted, you may delete it. This removes the definition of the tag from the database, and removes the tag from all revisions and log entries to which it is applied.
You cannot delete tags with more than 5,000 uses, for performance reasons.
To delete a tag, click the "delete" link beside a tag. (If you do not see this link, the tag cannot be deleted.) Enter a reason, and click "Submit".
Deleting a tag added by the software
You cannot delete a tag that is defined by the software, unless the software specifically allows it.
However, administrators can hide the tag from view by going to Special:Tags and changing the corresponding interface message (under the "Appearance in change lists" column) to a hyphen-minus character (-
).
Activating or deactivating a tag
Users can only apply tags that are both user-defined ("Source" column shows "Applied manually by users and bots") and active ("Active?" column shows "Yes"). For tags that are user-defined, you can use the "activate" or "deactivate" links to change the value in the "Active?" column, thereby allowing or forbidding users to add the tag to revisions or log entries.
You cannot activate or deactivate a tag that is defined by the software.