Help:Shortcuts
A shortcut is a specialized type of redirect page that provides an abbreviated wikilink to an administrative page or one of its sections, usually from the Wikipedia namespace or Help namespace. These shortcuts' abbreviations in all-caps text are commonly used (linked or unlinked) on community pages and talk pages, but should not be used in articles themselves. If there are one or more shortcuts for a page or section, one or more will usually be chosen to be displayed in an information box on the right labelled Shortcut or Shortcuts, as can be seen at the top of this page.
Shortcuts are created for the convenience of editors. It is possible to create a shortcut for any page. The existence of a shortcut does not imply or prove that the linked page is a policy or guideline.
How to use a shortcut
A Wikipedia shortcut can be entered into the Wikipedia search box to quickly bring you to a project page. For example, you can type AA:R or H:R into the search box and then press the enter key (or click the magnifying glass icon), to get to the Help:Redirect page, instead of having to type in the complete phrase.
Alternatively, you can use a shortcut in the URL in your browser's address bar. For example, you are currently viewing the Wikipedia:Shortcut page. The URL for this page is https://en.wikipedia.org/wiki/Shortcut. You could then get from here to the Help:Redirect page by replacing Help:Shortcut with AA:R in the address bar, followed by pressing the enter key. (If your browser has relative URL entry, simply prefix the shortcut with ./ instead of having to edit the existing URL.)
Shortcuts are presented in all capital letters (ALL CAPS); however, the search box is case-insensitive. For example, in the search box, you can type AA:r, instead of AA:R. However, when using the URL method (or when making links) it is necessary to match the capitalization of the shortcut itself.
Readability
Shortcuts are often used on talk pages in their abbreviated form, decreasing readability for the general reader. For example, some editors are familiar with the bulk of the most common namespace shortcuts, recognizing what they stand for on sight. Others, however, are faced with pages full of incomprehensible jargon, the meaning of which is not immediately clear.
To avoid these problems, a good practice when creating shortcuts is to choose common English words that are easily identifiable and memorable. Another good practice is to be mindful of the general reader and use meaningful terms when citing an obscure shortcut. For example, the piped link [[AA:SHC|shortcut]]
gives readers an idea of the subject of the target page, while the bare abbreviation [[AA:SHC]]
is unintelligible to those unfamiliar with the term.
It should also be remembered that shortcuts are a convenience, not a substitute for titles. Shortcuts should not appear in "See also" sections, hatnotes or any other place where a page title is expected.
Link boxes
Small link boxes, listing the names of the page's shortcuts, appear at the top of many pages, especially those on policies and guidelines. A shortcut link box can be added to a page, by placing the template {{shortcut|AA:<x>}}
(for project namespace) or {{shortcut|H:<x>}}
(for Help pages) at the top of the page's text, while editing. For template redirects, {{Template shortcut}}
is used instead.
The point of these template boxes is not to list every single redirect for any given page (that's what Special:WhatLinksHere is for). Instead, they generally should list only the most common and easily remembered redirects. One way to check which is the most common is through the Pageviews tool (replace the examples with the shortcuts you are testing).
Guideline pages with shortcuts pointing to them typically use {{guideline|AA:<x>}}
, such as on this page, instead of the shortcut template {{shortcut}}
. Another frequently used template is: {{MoS-guideline|MOS:<x>}}
.
To learn more about the different shortcut box templates and their functions, see documentation at {{shortcut}}. Among other things, there are templates for making boxes flow to the left and now, anchors are automatically added, making it much simpler to link to a page section.
Shortcut names
Shortcut names are almost always in uppercase.
A shortcut is typically named using the following convention:
PREFIX:SUFFIX
In the above form, the prefix is typically one of the prefixes in the following section, and the suffix is an acronym or abbreviation of the redirect target. However quite a lot are simply AA:BAD.
If the target is a sub-page, the following conventions are common (where 'Y' is an additional sequence of uppercase characters or numerals):
PREFIX:SUFFIX/Y
- For example, AA:US/IA is a shortcut to AARoads:United States/Iowa, which is a subpage of AARoads:United States, which has a shortcut AA:US.
Shortcuts that do not follow the above naming convention are discouraged, and are typically deleted.
The directory of shortcuts contains several conflicts for prefixes of subpages, often caused by a shortcut being 're-targeted' (modified to point to a new target page) without the shortcuts to subpages also being re-targeted.
Before creating a shortcut, use Special:PrefixIndex to ensure that the same prefix is not being used for different purposes. e.g. AA:CJ has several existing uses. No additional confusion would be caused by creating a shortcut AA:CJQ, however creating a shortcut AA:CJ/Q would be adding to the existing mess. There is a long-standing feature request to resolve shortcut subpages automatically. (See .)
List of prefixes
Namespace aliases
The following namespace aliases are automatically translated by the Wikipedia servers.
Alias | Namespace |
---|---|
AA: | AARoads: |
AT: | AARoads talk: |
Project: | AARoads: |
Project talk: | AARoads talk: |
Image: | File: |
Image talk: | File talk: |
TM: | Template: |
They are case-insensitive (so aa: or Aa: or AA: have the same meaning as AA:). For example, both aa:US and AA:US link directly to AARoads:United States.
One unique feature of the AA: alias is its utility in searching for the vast number of project pages. This is because most project pages outside the Wikipedia namespace, will have a redirect for the Wikipedia namespace prefix appended to their title and the same for most major shortcuts to them (e.g., Help:Watchlist, with the shortcut H:W, has redirects at Wikipedia:Watchlist and at AA:W. Thus, by extension, most project pages may be found by searching using the AA: alias alone, e.g. AA:Name
. For more, see Help:WP search protocol.
Pseudo-namespaces
When the shortcut does not use one of the namespace aliases listed above (WP or WT), it is a cross-namespace redirect and is case-sensitive.
However, when a prefix is used by multiple shortcuts, and has broad community support, it is referred to as a pseudo-namespace to distinguish these shortcuts from other cross-namespace redirects. (Note that the term "pseudo-namespace" is also used to refer to namespaces without content that are provided by the MediaWiki software and extensions, such as Special:, Media:, Feedback:)
The following prefixes may be used freely for the target listed:
Prefix | Target |
---|---|
CAT: | Category: |
H: | Help: |
Other prefixes do not enjoy the same level of community support. It is disputed whether they should be deemed to be pseudo-namespaces.
The following prefixes are used for limited or specific uses only:
T: | Template: |
MP: | Main Page |
Technical note: The links in the tables above go to a page where the term prefix is not used in the meaning as it has in this section. Rather, the code PrefixIndex there means, as it does for the search parameter, "the beginning string of characters in a title", whether that string ends before, during or after the colon character in a page name.
How to create a shortcut
When creating a shortcut, consider that many shortcuts are acronyms or initialisms; others are abbreviations or single but memorable words from a longer page title.
- Create the new page
AARoads:IA
, without yet publishing it. - Place the following in said page:
#REDIRECT [[AARoads:United States/Iowa]]
- The resulting shortcut will be AA:IA.
- In a new tab, go to the intended target page, AARoads:United States/Iowa
- Switch into Edit source mode of the page
- Place the template below the heading you created the shortcut for.
{{shortcut|AA:IA}}
- Publish the edit.
- Go back to the potential shortcut page tab.
- Publish the shortcut page.
- Finally, check if it works.
If you're creating a shortcut to a category, you need to insert an additional colon (":") at the beginning of the link, as in the following.
#REDIRECT [[:Category:Redirects from shortcuts]]
Changing shortcuts
Before changing a shortcut, consider its existing usage:
- Above all, check the shortcut backlinks with "what links here"; changing a shortcut used elsewhere can be highly disruptive.
- You should take into account how active its target page is.
- For example, if you just created a WikiProject and want a specific shortcut for it, but the one you want is already in use by another project, it's generally recommended to post a message on that project's talk page asking the members if you may change the link, even if the project is tagged as {{WikiProject status|inactive}}.
- If it was used in any closed deletion discussions, it is not a good idea then to change the redirect because these discussions cannot be edited.
- If it has no backlink, folks might still use it directly when searching. If you're not 100% sure that the old target is unused, ask about it on the shortcut's talk page.
To change the shortcut,
- Click on it.
- On the page it leads to, click on the "redirected from" link below the main title of the page or click again on the shortcut in the tag or on the side of the page.
- This takes you to the actual shortcut page, which is a redirect. You should notice
&redirect=no
in the URL.
- This takes you to the actual shortcut page, which is a redirect. You should notice
- Edit the target
#REDIRECT AARoads:Whatever
.
Limitations
Redirects (including shortcuts) to pages on other projects and special pages won't work—this formerly supported feature was abused and hence it has been disabled. The software will display the redirect page instead of redirecting the user to the target.
Some redirects to other projects and special pages use the template {{soft redirect}}; however, shortcuts that are soft redirects will appear in the pool of pages that are selected by Special:Random. Soft redirects are categorised into Category:Soft redirects.