Wikipedia:Manual of Style/Linking#Principles

{{Short description|English Wikipedia guideline}}

{{pp-move-indef}} {{For|technical information about link formatting|Help:Link}}

{{For|information on adding external links to articles|Wikipedia:External links}}

{{pp-semi-indef|small=yes}}

{{Style-guideline|MOS:L|WP:LINK|MOS:LINK|WP:MOSLINK}}

{{Style}}

{{Linking and page manipulation|linking and diffs}}

Linking through hyperlinks is an important feature of Wikipedia. Internal links bind the project together into an interconnected whole. Interwikimedia links bind the project to sister projects such as Wikisource, Wiktionary and Wikipedia in other languages, and external links bind Wikipedia to the World Wide Web.

Appropriate links provide instant pathways to locations within and outside the project that can increase readers' understanding of the topic at hand. Whenever writing or editing an article, consider not only what to put in the article, but also what links to include to help the reader find related information, and also which other pages should have links to the article. Avoid both underlinking and overlinking, as described below.

This page provides guidelines as to when links should and should not be used, and how to format links. For information about the syntax used to create links, see Help:Link. For links on disambiguation pages, see Wikipedia:Manual of Style/Disambiguation pages.

<span id="General principles"></span> Principles

{{Redirect|WP:BUILD|the behavioral guideline|Wikipedia:Here to build an encyclopedia}}

{{Shortcut|MOS:BTW|MOS:BUILD}}

Wikipedia is based on hypertext, and aims to "build the web" to enable readers to access relevant information on other Wikipedia pages easily. The page from which the hyperlink is activated is called the anchor; the page the link points to is called the target.

In adding or removing links, consider an article's place in the knowledge tree. Internal links can add to the cohesion and utility of Wikipedia, allowing readers to deepen their understanding of a topic by conveniently accessing other articles. Ask yourself, "How likely is it that the reader will also want to read that other article?" Consider including links where readers might want to use them; for example, in article leads, at the openings of new sections, in the cells of tables, and in file captions. But as a rule of thumb, link only the first occurrence of a term in the text of the article.

=General points on linking style=

{{Shortcut|MOS:LINKSTYLE|MOS:INTERNAL}}

  • As explained in more detail at {{section link|Help:Link|Wikilinks}}, linking can be direct (Riverside, California, which results in {{xt|Riverside, California}}), or piped (Riverside, which results in {{xt|Riverside}} in the text, but still links to the article "Riverside, California"—although the pipe trick is an easier way to create this particular link).
  • {{Shortcut|MOS:HEADINGLINK}} {{anchor|No links in headers}} Section headings should not themselves contain links; instead, a {{tl|main}} or {{tl|see also}} template should be placed immediately after the heading.
  • Links should not be placed in the boldface reiteration of the title in the opening sentence of a lead.{{efn|1=Many, but not all, articles repeat the article title in bold face in the first line of the article. Linking the article to itself produces boldface text; this practice is discouraged as page moves result in a useless circular link through a redirect. Linking part of the bolded text is also discouraged because it changes the visual effect of bolding; some readers can miss the visual cue which is the purpose of using bold face in the first place.}}
  • {{Shortcut|MOS:NOLINKQUOTE}} {{anchor|Linking quotations}}Be conservative when linking within quotations; link only to targets that correspond to the meaning clearly intended by the quote's author. Where possible, link from text outside of the quotation instead – either before it or soon after.{{efn|1=If quoting hypertext that includes a Wikipedia link particularly salient to the quote's use, a {{xt|[link in original]}} editorial note may be added. {{xt|[link added]}} notes should generally be avoided, because if the clarification is needed badly enough to justify disrupting the flow of text, the link is probably not conservative and should be omitted.}}
  • {{Shortcut|MOS:SOB|MOS:SEAOFBLUE|MOS:WINGSUIT}} {{anchor|Sea of blue|Dribbles of blue|Wingsuit combat}} When possible, do not place links next to each other, to avoid appearing like a single link, as in wingsuit combat (wingsuit combat) or chess tournament (chess tournament). Instead, consider using a single, more specific link such as chess tournament (chess tournament), or if not possible, consider omitting one of the links (chess tournament) or rephrasing the sentence (tournament of chess).
  • {{Shortcut|MOS:GEOLINK}} {{anchor|Geographic places}} For a geographical location expressed as a consecutive comma-separated sequence of two or more territorial units, link only the first unit.
  • For example, avoid
  • :{{cross}}Sydney, Australia (Sydney, Australia)
  • ::or
  • :{{cross}}Quothquan, South Lanarkshire, Scotland (Quothquan, South Lanarkshire, Scotland)
  • ::or
  • :{{cross}}Buffalo, New York, United States (Buffalo, New YorkUnited States)
  • Instead, use
  • :{{tick}}Sydney, Australia (Sydney, Australia)
  • ::or
  • :{{tick}}Quothquan, South Lanarkshire, Scotland (Quothquan, South Lanarkshire, Scotland)
  • ::or
  • :{{tick}}Buffalo, New York, United States (Buffalo, New York, United States)
  • If the smallest unit is an extant place, but the largest is not, it is preferable to space the links out when feasible, e.g. {{tq|Kumrovec, then part of Austria-Hungary}} (Kumrovec, then part of Austria-Hungary).
  • Linked text should avoid leading and trailing spaces. Punctuation, including spaces, should be external to the linked items.
  • Articles on technical subjects might demand a higher density of links than general-interest articles, because they are likely to contain more technical terms that general dictionaries are unlikely to explain in context.
  • Beware of linking to an article without first confirming that the target article covers the appropriate topic. For example, an article mentioning the physics unit "barn" should link to barn (unit), not barn.
  • {{Shortcut|MOS:DRAFTNOLINK|WP:CROSSLINK}}{{anchor|Draft space}}In articles, do not link to pages outside the article namespace, including draft articles, except in articles about Wikipedia itself (and even in that case with care{{snd}}see Wikipedia:Manual of Style/Self-references to avoid).
  • Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so.
  • {{Shortcut|MOS:NOFORCELINK|MOS:FORCELINK|}}{{anchor|Forced links}} Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence. The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links.
  • Refrain from implementing colored links that may impede user ability to distinguish links from regular text, or color links for purely aesthetic reasons.

==<span id="Underlinking"></span>What generally should be linked==

{{Redirect|MOS:UL|unordered lists|Wikipedia:Manual of Style/Lists#Embedded lists|underlining|Wikipedia:Manual of Style/Text formatting#How not to apply emphasis}}

{{Shortcut|MOS:UL|MOS:UNDERLINK}}

An article is said to be underlinked if unlinked words are needed to aid understanding of the article. In general, links should be created for:

  • Relevant connections to the subject of another article that help readers understand the article more fully (see the example below). This can include people, events, and topics that already have an article or that clearly deserve one, as long as the link is relevant to the article in question.
  • Articles with relevant information, for example: "{{xt|see Fourier series for relevant background}}"
  • Articles explaining words of technical terms, jargon or slang expressions or phrases—but you could also give a concise definition instead of or in addition to a link. If there is no appropriate Wikipedia article, an interwikimedia link to Wiktionary could be used.
  • Proper names that are likely to be unfamiliar to readers

If you feel that a link is relevant to the topic of the article but does not belong in the body of an article, consider moving it to a "See also" section.

Links may be created to potential articles that do not yet exist (see {{section link||Red links}}). If an article exists on a non-English language Wikipedia but not yet in English, consider a red link that also links to the non-English language article (see {{section link|Help:Interlanguage links|Inline links}}).

== <span id="Overlinking"></span> What generally should not be linked ==

{{Shortcut|MOS:OL|MOS:OVERLINK}}

An article is said to be overlinked if it contains an excessive number of links, making it difficult to identify those likely to aid a reader's understanding.{{cite magazine |author-link= John C. Dvorak |last=Dvorak |first=John C. |title=Missing Links |work=PC Magazine |date=April 16, 2002 |url= https://www.pcmag.com/article2/0,1759,33326,00.asp |access-date=August 16, 2021 |archive-url= https://web.archive.org/web/20110806041207/https://www.pcmag.com/article2/0,2817,33326,00.asp |archive-date=August 6, 2011}}{{efn|1=A 2015 study of log data found that "in the English Wikipedia, of all the 800,000 links added ... in February 2015, the majority (66%) were not clicked even a single time in March 2015, and among the rest most links were clicked only very rarely", and that "simply adding more links does not increase the overall number of clicks taken from a page. Instead, links compete with each other for user attention." This was reported in: {{cite conference |first1=Ashwin |last1=Paranjape |first2=Bob |last2=West |first3=Jure |last3=Leskovec |first4=Leila |last4=Zia |contribution=Improving Website Hyperlink Structure Using Server Logs |title=WSDM'16: Proceedings of the Ninth ACM International Conference on Web Search and Data Mining |date=February 22–25, 2016 |publisher=Association for Computing Machinery |location=San Francisco |url= http://infolab.stanford.edu/~west1/pubs/Paranjape-West-Leskovec-Zia_WSDM-16.pdf |isbn=9781450337168 |doi=10.1145/2835776.2835832}} }} A good question to ask yourself is whether reading the article you're about to link to would help someone understand the article you are linking from. Unless a term is particularly relevant to the context in the article, words and terms understood by most readers in context are usually not linked. Be conscious of your own demographic biases when determining whether certain terms have this level of recognizability{{snd}}what is well known in your age group, line of work, or country may be less so for others. Examples include:

  • Everyday words (e.g., education, violence, aircraft, river, animation)
  • Common occupations (e.g., accountant, politician, actor)
  • Common units of measurement, often those relating to time, temperature, length, area, or volume. If both non-metric and metric equivalents are given, as in {{xt|{{convert|5|cm|in|0}}}}, usually neither unit needs to be linked, because almost all readers understand at least one of the units.
  • Dates {{crossref|(see {{section link||Chronological items}}, below)}}
  • Disambiguation pages should not be linked from articles unless the link is purposeful, such as in a hatnote. Instead, use a piped link to the appropriate article. For example, use {{mxt|{{y}}Moana}} for the Disney character, which appears as Moana and leads to the intended page{{emdash}}instead of {{!mxt|{{n}}Moana}}, which appears identical but leads to a disambiguation page.

In addition, {{em|major}} examples of the following categories should generally not be linked:

  • Countries (e.g., Brazil/Brazilian, Canada/Canadian, China/Chinese)
  • Geographic features (e.g., the Himalayas, Pacific Ocean, South America)
  • Settlements or municipalities (e.g., New Delhi; New York City, or just New York if the city context is already clear; London, if the context rules out London, Ontario)
  • Languages (e.g., English, Arabic, Korean, Spanish)
  • Nationalities, ethnicities or identities (e.g., British, Japanese, Turkish, African American, Nigerian)
  • Religions (e.g., Christianity, Islam, Hinduism, Buddhism)

Links may be excessive even if they are informative. For example, because inline links present relatively small tap targets on touchscreen devices, placing several separate inline links close together within a section of text can make navigation more difficult for readers, especially if they have limited dexterity or coordination. Balance readability, information, and accessibility when adding multiple links in one section of text. As of 2024, most stub articles average two links per sentence, or about 10 to 20 links total. Most longer articles average somewhere around one link per 20 words. The lead of an article usually has a greater density of links than later parts of the article.

{{Anchor|Circular|Circ}}

{{Shortcut|MOS:CIRCULAR|MOS:CIRC}}

Do not link to pages that redirect back to the page the link is on (unless the link is to a redirect with possibilities that links to an appropriate section of the current article).

The purpose of linking is to clarify and to provide reasonable navigation opportunities, not to emphasize a particular word. Do not link solely to draw attention to certain words or ideas, or as a mark of respect.

External links normally should not be placed in the body of an article (see Wikipedia:External links).

==Lead section==

{{Shortcut|MOS:LEADLINK}}

{{for|links in the first sentence|Wikipedia:Manual of Style/Lead section#Contextual links}}

Too many links can make the lead hard to read. In technical articles that use uncommon terms, a higher-than-usual link density in the lead section may be necessary. In such cases, try to provide an informal explanation in the lead, avoiding using too many technical terms until later in the article. (See Wikipedia:Make technical articles understandable and Wikipedia is not a scientific journal.)

Most Featured Articles contain about 12 to 25 links in the lead, with an average of about 1.5 links per sentence, or one link for every 16 words.{{cite web |title=User:WhatamIdoing/Sandbox 3 |date=January 30, 2023 |url= https://en.wikipedia.org/w/index.php?title=User:WhatamIdoing/Sandbox_3&oldid=1136368242 |work=Wikipedia |edition=English |access-date=August 31, 2023}}

==<span class="anchor" id="An example article"></span>An example article==

{{Shortcut|MOS:LE|MOS:LINKEXAMPLES|MOS:EXAMPLELINKS|MOS:COMMONWORDS}}

For example, in the article on supply and demand:

  • Almost certainly link "microeconomics" and "general equilibrium theory", as these are technical terms that many readers are unlikely to understand at first sight.
  • Consider linking "price" and "goods" only if these common words have technical dimensions that are specifically relevant to the topic.
  • Do not link to the "United States", because that is an article on a very broad topic with no direct connection to supply and demand.
  • Definitely do not link "wheat", because it is a common term with no particular relationship to the article on supply and demand, beyond its arbitrary use as an example of traded goods in that article.
  • Make sure that the links are directed to the correct articles: in this example, you should link goods, not good, which goes to a page on the philosophical concept. Many common dictionary words are ambiguous terms in Wikipedia and linking to them is often unhelpful to readers; "Good" is a surname and the name of albums, companies, etc., and the article title Good (disambiguation) is used to index those.

=Link clarity=

{{Shortcut|MOS:LINKCLARITY}}

{{See also|#Piped links}}

The article linked to should correspond as closely as possible to the term showing as the link, given the context.

For example, a link to the article Requiem (Mozart) should be clear that it is Mozart's Requiem in particular, rather than requiems in general. The link target and the link label do not have to match exactly, but the link must be as intuitive as possible (see {{slink||Intuitiveness}}).

class="wikitable"

!

! Article text

! Wikitext

! Note

{{tick}}

| When Mozart wrote his Requiem

| When Mozart wrote his Requiem

| Includes the word "his" to specify

{{cross}}

| When Mozart wrote his Requiem

| When Mozart wrote his Requiem

| Only word "Requiem"

{{tick}}

| Previn conducted Mozart's Requiem

| Previn conducted Mozart's Requiem
or Previn conducted Mozart's Requiem

| Specifying that it is "Mozart's"

{{cross}}

| Previn conducted Mozart's Requiem

| Previn conducted Mozart's Requiem

| Only word "Requiem"

=Link specificity=

{{Shortcut|MOS:SPECIFICLINK}}

Always link to the article on the most specific topic appropriate to the context from which you link: it generally contains more focused information, as well as links to more general topics.

class="wikitable"

! What you type

! How it appears

! Specificity

Icelandic orthographyIcelandic orthography

| Specific (preferred)

Icelandic orthographyIcelandic orthography

| Related but less specific

Icelandic orthographyIcelandic orthography

| Unspecific

the flag of Tokelauthe flag of Tokelau

| Specific (preferred)

the flag of Tokelauthe flag of Tokelau

| Unspecific

RequiemRequiem

| Specific (preferred)

RequiemRequiem

| Unspecific

If there is no article about the most specific topic, do one of the following things:

  • Consider creating the article yourself.
  • If an article on the specific topic does not yet exist, create a redirect page to the article about a more general topic, as described in section {{section link||Redirects}}. For example, if no article yet exists on the song "Sad Statue" from the album Mezmerize, create a new article called Sad Statue that is a redirect to the article Mezmerize.
  • If there is no article on a more general topic either, then create a red link, but first, read {{section link||Red links}} below.

When neither a redirect nor a red link appears appropriate, consider linking to a more general article instead.

For example, instead of

{{cross}}{{xt|Baroque hairstyles}} (an article which, as of 2023, had never been created),

write

{{tick}}{{xt|Baroque hairstyles}} (which provides a link to the Baroque era),

{{tick}}{{xt|Baroque hairstyles}} (which provides a link to the article on hairstyle),

{{tick}}{{xt|Baroque hairstyles}} (which provides no link at all, and which may be preferable depending on context),

or

{{tick}}{{xt|hairstyles of the Baroque}} (which provides separate links to both topics);

however, do not create

{{cross}}{{xt|Baroque hairstyles}} as two adjacent links because they may be misinterpreted as linking to a single article on that topic.

Techniques

=Redirects=

{{Shortcut|MOS:RDR|MOS:REDIR}}

{{Main|Wikipedia:Redirect}}

Suppose you need to link poodle, and there is no such article yet. You might want to create a redirect from "poodle" to "dog" as follows: Link as usual: She owned a poodle. When you save or preview this, you see: {{xt|She owned a poodle}}. Follow the red link, and you are invited to create a new page for poodle; enter (perhaps) #REDIRECT Dog, so that readers clicking on poodle are taken, for now, to the dog article.

The redirect is better in a case like this than a direct link like poodle, because when an actual poodle article is eventually created (replacing the redirect), readers following the poodle link are taken there automatically without anyone needing to review all the links to dog to see which ones should actually go to poodle.

To link to a redirect page without following the underlying redirect, use e.g. {{no redirect|poodle}}.

Avoid linking redirects that are self links (WP:SELFRED).

==Style==

{{shortcut|MOS:PIPESTYLE}}

  • Plurals and other derived names. {{xt|apples}} displays as {{xt|apples}}, and this is simpler and clearer than {{xt|apples}}. Similarly: {{xt|appealing}}, {{xt|hyperlinked}}, {{xt|reddest}}. Some characters do not work after the link; see Help:Link for more details.
  • Case sensitivity. Links are not sensitive to initial capitalization, so there is no need to use the pipe character where the case of the initial letter is the only difference between the link text and the target page. (Wikipedia article titles almost always begin with a capital, whereas the linked words in context often do not.) However, links are case-sensitive for all characters after the initial one.

==Intuitiveness==

{{redirect|MOS:EGG|text=You may also be looking for WP:EASTEREGG}}

{{shortcut|MOS:EGG|MOS:EASTEREGG|MOS:SUBMARINE}}{{Anchor|EGG|SUBMARINE|ASTONISH}}

File:Easter egg hunt.JPG

Keep piped links as intuitive as possible. Per the principle of least astonishment, make sure that the reader knows what to expect when following a link. You should plan your page structure and links so that everything appears reasonable and makes sense.

A link's visible label does not need to match the exact title of the article being linked, such as in {{Mxt|suture}} or {{Mxt|passed the ball}}. However, avoid "Easter egg" or "submarine" links, which are links that unexpectedly hide relevant information underneath the link's label. For example, do not write:
{{in5}}{{!mxt|Richard Feynman was also known for work in particle physics.}}
Here readers would see the link displayed as {{xt|particle physics}}, not the hidden reference to the page {{xt|Parton (particle physics)}}, unless they followed the link or inspected the target title e.g. by mousing over it. If a physical copy of the article were printed, or the article saved as an audio file, the reference to the parton model would be lost.

Instead, refer to the separate article with an explicit see also X, or by rephrasing the sentence, as in:
{{in5}}{{mxt|Richard Feynman was also known for work in particle physics, especially the parton model.}}

==Names in names==

{{shortcut|MOS:LINKINNAME|MOS:PARTIALNAMELINK}}

Do not place a link to a name within another name. For example:

style="text-align:right; margin-left:44.8px"

! Write:

| {{mxt|Columbus Avenue}}

Columbus Avenue
Do not write:

| {{!mxt|Columbus Avenue}} || → Columbus Avenue

Write:

| {{mxt|Feynman diagram}} || → Feynman diagram

Do not write:

| {{!mxt|Feynman diagram}} || → Feynman diagram

The above applies regardless of whether linking to the full name creates a red link; for example, even if there is no article titled Lafayette Avenue (Brooklyn):

style="text-align:right; margin-left:44.8px"

! Do not write:

| {{!mxt|Lafayette Avenue}}

Lafayette Avenue

See also {{slink||Link clarity}}.

==Piping and redirects<span class="anchor" id="NOPIPE"></span><span class="anchor" id="Piping and redirects"></span>==

{{Shortcut|MOS:NOPIPE|MOS:DYKPIPE}}

Per WP:NOTBROKEN and {{section link||Link specificity}} above, do not use a piped link where it is possible to use a redirected term that fits well within the scope of the text. For example, the page {{xt|Papageno}} is a redirect to the article about Mozart's opera The Magic Flute (since Papageno is a character in The Magic Flute). While editing some other article, you might want to link the term {{xt|Papageno}}; here, you might be tempted to avoid the redirect by using a pipe within the link, as in {{!xt|Papageno}}. Instead, write simply {{xt|Papageno}} and let the system handle the rest. This has two advantages: first, if an article is written later about the more specific subject (in this case, "Papageno", the character), fewer links need to be changed to accommodate the new article; second, it indicates that the article is wanted.

An exception to this rule is when linking to articles in Did you know (DYK) "hooks" on the Main Page, where piping links to prevent readers from seeing a redirect notice is preferable, and the hook is live only for a short time. {{crossref|(See also {{section link|WP:Piped link#When not to use}}.)}}

===Redirects to sections which may become articles===

Many topics useful for linking may currently appear only as sections of other Wikipedia articles, but are potentially notable enough to become articles on their own. For example, the article {{xt|Eastern Anyshire}} might have a small "History" section, but this does not prevent the article {{xt|History of Eastern Anyshire}} being written eventually. A redirect page from such a sub-topic to a general topic may exist already; if not, a redirect can be created when the occasion arises. It is bad practice to create links in article text using the format Article#Section; navigation then becomes difficult if the section is expanded into a new article. Instead, link using a redirect to the main topic; it costs little and makes improvements easier. Thus:

  • In a redirect page named "History of {{var|Topic}}", use {{mxt|#REDIRECT Topic}}#History}}.
  • In another article, use {{mxt|Topic}}}}.
  • Avoid: {{!mxt|{{var}}.

== Links to non-English language pages ==

See {{section link|Help:Interlanguage links|Inline links}}.

=Links to Wikipedia's categories=

{{See also|Wikipedia:Colon trick}}

Wikipedia has categories of articles; for example, "Phrases". Adding the wikitext {{xt|Category:Phrases}} to an article will add that article to the category "Phrases". (This will not create any visible addition to the body text of the article.)

If you instead want to create a visible link to a category, add a colon in front of the word "Category". For example, {{xt|:Category:Phrases}} creates the link :Category:Phrases. As with other links, piping can be used: Phrases.

The {{tl|See also cat}} template can be used instead:

{{xt|{{See also cat|Phrases}}}} creates: {{See also cat|Phrases}}

Specific cases

=<span id="Chronological items"></span><span id="Year linking"></span><span id="Month-and-day linking"></span>Linking month-and-day or year=

{{Shortcut|WP:DATELINK|WP:YEARLINK|WP:LINKYEAR}}

Month-and-day articles (e.g. February 24 and 10 July) and year articles (e.g. 1795, 1955, 2007) should not be linked unless the linked date or year has a significant connection to the subject of the linking article, beyond that of the date itself, so that the linking enhances the reader's understanding of the subject.

For example:

  • The date (or year) should not be linked in a sentence such as (from Sydney Opera House): "{{xt|The Sydney Opera House was made a UNESCO World Heritage Site on 28 June 2007}}", because little if any content of either June 28 or 2007 pertains to either UNESCO, World Heritage Sites, or the Sydney Opera House.
  • The years of birth and death of architect Philip Johnson should not be linked, because little if any content of 1906 or 2005 enhances the reader's understanding of Johnson or his work.
  • 1942 might be linked from another article about WWII.
  • 1787 might be linked from a passage discussing a particular development in the metric system which occurred in that year.

However, in intrinsically chronological articles (1789, January, and 1940s), links to specific month-and-day, month-and year, or year articles are not discouraged.

Commemorative days (Saint Patrick's Day) are not considered month-and-day items for the purposes of the above.

=<span id="Units"></span> Units of measurement that are not obscure=

Generally, a unit should be linked only if it is likely to be obscure to many readers or is itself being discussed. For example, the troy ounce, bushel, hand, candela, knot, mho, or millibarn might be considered obscure even if they are well-known within their field of use. Other units may be obscure in some countries even if well known in others.

=Syntax=

The syntax for referencing a web address is simple. Just enclose it in single brackets with a space between the URL and the text that is displayed when the page is previewed or saved:

:[https://www.example.org Text to display]

The text appears as:

:[https://www.example.org Text to display]

The URL must begin with either http:// or https:// (preferring https://, where available), or another common protocol, such as ftp:// or news://. If no protocol is used, the square brackets display normally – [like this] – and can be used in the standard way.

In addition, putting URLs in plain text with no markup automatically produces a link, for example https://www.example.org/ → {{xt|https://www.example.org/}}. However, this feature may disappear in a future release. Therefore, in cases where you wish to display the URL because it is intrinsically valuable information, it is better to use the short form of the URL (domain name) as the optional text: [https://www.example.org/ example.org] produces {{xt|[https://www.example.org/ example.org]}}.

Citations templates such as {{tlx|cite web}} should not be used in the ==External links== section. External link templates such as {{tlx|official website}} are used instead of citation templates.

=Link titles=

{{Main|Wikipedia:Embedded citations}}

Embedded HTML links within an article are a now-deprecated way to supply a bare URL as a source within an article, by simply enclosing the URL in square brackets, like this: [https://www.guardian.co.uk/usa/story/0,12271,1650417,00.html] → {{xt|[https://www.guardian.co.uk/usa/story/0,12271,1650417,00.html]}}. However, you should add a descriptive title when an external link is offered in the References, Further reading, or External links sections. This is done by supplying descriptive text after the URL, separated by a space and enclosing it all in square brackets.

For example, to add a title to a bare URL such as https://en.wikipedia.org/ (this is rendered as {{xt|https://en.wikipedia.org/}}), use the following syntax: [https://en.wikipedia.org/ an open-content encyclopedia] (this is rendered as "{{xt|[https://en.wikipedia.org/ an open-content encyclopedia]}}").

{{Shortcut|MOS:URL|MOS:DOMAINNAME}}{{anchor|URL|reason=This is the target of the shortcuts.}}

Generally, URLs and domain names are ugly and uninformative; it is better for a meaningful title or description to be displayed rather than the URL or domain itself. For example, {{xt|[http://www.esa.int/ESA European Space Agency website]}} is much more reader-friendly than {{xt|http://www.esa.int/ESA}}. There may be exceptions where the domain name is well known or is also the company or publication name. When a URL or domain name is given, putting both a plain-English title or description and the URL is often more informative: for example, {{xt|[http://www.esa.int/ESA European Space Agency website, www.esa.int]}}.

If the URL or domain name {{em|is}} displayed, make it as simple as possible; for example, if the index.html is superfluous, remove it (but be sure to check in preview mode first). Many but not all sites can be trimmed of a leading "www."; test it to be sure. Use camel case to make a displayed domain more readable, e.g. {{xt|WashingtonPost.com}} versus {{xt|washingtonpost.com}}.

The "printable version" of a Wikipedia article displays all URLs in full, including those given a title, so no information is lost.

=Position in article=

{{Main|MOS:ORDER}}

Embedded links that support information in an article are positioned in the same manner as any other reference in the article, following the usual standards about citation formatting and placement in relation to punctuation.

Links that are not used as sources can be listed in the External links section, like this:

: ==External links==

: * [https://...]

: * [http://...]

As with other top-level headings, two equal signs should be used to mark up the external links heading (see {{section link|Wikipedia:Manual of Style/Layout|Headings}}). External links should always be the last section in an article. It precedes categories and some kinds of navigation templates.

If there is a dispute on the position of an embedded link, consider organizing alphabetically.

=Non-English-language sites=

Webpages in English are highly preferred. Linking to non-English pages may still be useful for readers in the following cases:

  • When the website is the subject of the article
  • When linking to pages with maps, diagrams, photos, tables (explain the key terms with the link, so that people who do not know the language can interpret them)
  • When the webpage contains information found on no English-language site of comparable quality, and is used as a citation (or when translations on English-language sites are not authoritative).

If the language is one that most readers could not be expected to recognize, or is for some other reason unclear from the name of the publication or the book or article or page title, consider indicating what language the site is in.

  • Example: {{xt|[http://www.kohajone.com/ Koha Jonë], an Albanian-language newspaper from Tirana}}
  • Example: {{Xt|[https://www.elpais.es/ El País], a Spanish-language newspaper from Madrid}}

You can also indicate the language by putting a language template after the link. This is done using Template:In lang by typing {{Tlx|In lang|<{{var|language code}}>}}. For example, {{Tlx|In lang|es}} displays as: {{xt|{{in lang|es}}}}. See list of ISO 639 codes.

When using one of the {{cs1}} or {{cs2}} templates, instead of the {{tld|In lang}} template, use the {{para|language}} parameter. This parameter accepts language names or language codes; see this list of supported names and codes. (Use of language codes is to be preferred because cs1|2 automatically renders language names in the language of the local Wikipedia.)

=File type and size=

If the link is not to an HTML or PDF file (the latter is identified automatically by the software with an icon like this: {{xt|[https://www.example.com/test.pdf]}}), identify the file type. Useful templates are available: {{tl|DOClink}}, {{tl|RTFlink}}. If a browser plugin is required to view the file, mention that as well. If a link is to a PDF file but doesn't end with .pdf, you can put a #.pdf at the end to flag it as a PDF.

If the link is to a very large page (considering all its elements, including images), a note about that is useful since someone with a slow or expensive connection may decide not to visit it.

=Linking=

Using links to wiktionary as an example, interwiki links can take the form of:

:wikt:article which appears as: wikt:article

The pipe symbol suppresses the prefix:

:article

Adding text after the pipe allows either the same or a different text (with no prefix):

:articlearticle

:Any textAny text

To avoid reader confusion, inline interlanguage, or interwiki, linking within an article's body text is generally discouraged. Exceptions: Wiktionary and Wikisource entries may be linked inline (e.g. to an unusual word or the text of a document being discussed), and {{tl|Interlanguage link}} template may be helpful to show a red link accompanied by an interlanguage link if no article exists in English Wikipedia.

=Floating boxes=

{{wikiquote|Jimmy Wales}}Floating boxes for links to articles in other Wikimedia Foundation projects such as Wiktionary and Wikiquote can be added using interwiki link sidebar templates, for example {{Wikiquote|Jimmy Wales}}. These display as a shaded box with a logo.

(There is a related set of templates for some free content resources that are not run by the Wikimedia Foundation. Rather than creating a sidebar link, they create text suitable for using as a bulleted entry in an "External links" section. A list of such templates can be found at Wikipedia:List of templates linking to other free content projects.)

Link maintenance

Linking and continual change are both central features of Wikipedia. However, continual change makes linking vulnerable to acquired technical faults, and to the later provision of different information from that which was originally intended. This is true of both "outgoing" links (from an article) and "incoming" links (to an article).

  • Outgoing links: These should be checked from time to time for unintended changes that are undesirable. If the opportunity arises to improve their formatting, appropriateness, and focus, this should be done.
  • Incoming links: Creating an article turns blue any existing red links to its title. Proper redlinks are created only in the hope that an article will eventually be written. Therefore, when creating an article, it is wise to check "What links here" to identify such redlinks, if any, and that they are appropriate.

Buttons

{{Shortcut|MOS:BUTTONS}}

Buttons should not be used in articles. If the desire is to "navigate" a reader to a new page, taking them away from the current page, a link is preferred. Buttons are used within Wikipedia to trigger an "action", such as {{Clickable button|Show preview|color=blue}} or {{Clickable button|Create account|color=blue}} or {{Clickable button|Reply|color=blue}} or {{Clickable button|Ask a question|color=blue}}.{{cite web |url= https://doc.wikimedia.org/codex/latest/components/demos/button.html |title=Codex: Wikimedia Design System |at="Components: Button" section |date=2024 |work=Doc.Wikimedia.org |publisher=Wikimedia Foundation}}

See also

{{Columns-list|colwidth=30em|

}}

Notes

{{Notelist}}

References

{{Reflist}}