W3cubDocs

/HTML

Link types

In HTML, the following link types indicate the relationship between two documents, in which one links to the other using an <a>, <area>, or <link> element.

List of the defined link types and their significance in HTML
Link Type Description Allowed in these elements Not allowed in these elements
alternate
  • If the element is <link> and the rel attribute also contains the stylesheet type, the link defines an alternative style sheet; in that case the title attribute must be present and not be the empty string.
  • If the type is set to application/rss+xml or application/atom+xml, the link defines a syndication feed. The first one defined on the page is the default.
  • Otherwise, the link defines an alternative page, of one of these types:
    • for another medium, like a handheld device (if the media attribute is set)
    • in another language (if the hreflang attribute is set),
    • in another format, such as a PDF (if the type attribute is set)
    • a combination of these
 <a>, <area>, <link> None.
archives Defines a hyperlink to a document that contains an archive link to this one. For example, a blog entry could link to a monthly index page this way.

Note: Although recognized, the singular archive is incorrect and must be avoided.		 <a>, <area>, <link> None.
author Defines a hyperlink to a page describing the author or providing a way to contact the author.

Note: This may be a mailto: hyperlink, but this is not recommended on public pages as robot harvesters will quickly lead to a lot of spam sent to the address. In that case, it is better to lead to a page containing a contact form.

Although recognized, the rev attribute on <a>, <area> or<link> elements with a link type of made is incorrect and should be replaced by the rel attribute with this link type.		 <a>, <area>, <link> None.
bookmark Indicates that the hyperlink is a permalink for the nearest ancestor <article> element. If none, it is a permalink for the section that the element is most closely associated to.

This allows for bookmarking a single article in a page containing multiple articles, such as on a monthly summary blog page, or a blog aggregator.		 <a>, <area> <link>
canonical From Wikipedia, the free encyclopedia: Canonical_link_element
A canonical link element is an HTML element that helps webmasters prevent duplicate content issues by specifying the "canonical" or "preferred" version of a web page as part of search engine optimization.		 <link> ???
dns-prefetch Hints to the browser that a resources is needed allowing the browser to do a DNS lookup and protocol handshaking before a user clicks the link. <link> <a>, <area>
external Indicates that the hyperlink leads to a resource outside the site of the current page; that is, following the link will make the user leave the site. <a>, <area> <link>
first Indicates that the hyperlink leads to the first resource of the sequence the current page is in.

Note: Other link types related to linking resources in the same sequence are last, prev, next.

Although recognized, the synonyms begin and start are incorrect and must be avoided.		 <a>, <area>, <link> None.
help
  • If the element is <a> or <area>, it indicates that the hyperlink leads to a resource giving further help about the parent of the element, and its descendants.
  • If the element is <link> it indicates that the hyperlink leads to a resource giving further help about the page as a whole.
 <a>, <area>, <link> None.
icon Defines a resource for representing the page in the user interface, usually an icon (auditory or visual).

The media, type and sizes attributes allow the browser to select the most appropriate icon for its context. If several resources match, the browser will select the last one declared, in tree order. As these attributes are merely hints, and the resources may be inappropriate upon further inspection, the browser will then select another one, if appropriate.

Note: Apple's iOS does not use this link type, nor the sizes attribute, like others mobile browsers do, to select a webpage icon for Web Clip or a start-up placeholder. Instead it uses the non-standard apple-touch-icon and apple-touch-startup-image respectively.

The shortcut link type is often seen before icon, but this link type is non-conforming, ignored and web authors must not use it anymore.		 <link> <a>, <area>
index Indicates that the page is part of a hierarchical structure and that the hyperlink leads to the top level resource of that structure.

If one or several up link types are also present, the number of these up indicates the depth of the current page in the hierarchy.		 <a>, <area>, <link> None.
last Indicates that the hyperlink leads to the last resource of the sequence the current page is in.

Note: Other link types related to linking resources in the same sequence are first, prev, next.

Although recognized, the synonym end is incorrect and must be avoided.		 <a>, <area>, <link> None.
license Indicates that the hyperlink leads to a document describing the licensing information. If not inside the <head> element, the standard doesn't distinguish between a hyperlink applying to a specific part of the document or to the document as a whole. Only the data on the page can indicate this.

Note: Although recognized, the synonym copyright is incorrect and must be avoided.		 <a>, <area>, <link> None.
manifest Indicates that the linked file is a Web App Manifest. <link> <a>, <area>
next Indicates that the hyperlink leads to the next resource of the sequence the current page is in.

Note: Other link types related to linking resources in the same sequence are first, prev, last.		 <a>, <area>, <link> None.
nofollow Indicates that the linked document is not endorsed by the author of this one, for example if it has no control over it, if it is a bad example or if there is commercial relationship between the two (sold link). This link type may be used by some search engines that use popularity ranking techniques. <a>, <area> <link>
noopener

Instructs the browser to open the link without granting the new browsing context access to the document that opened it — by not setting the Window.opener property on the opened window (it returns null).

This is especially useful when opening untrusted links, in order to ensure they cannot tamper with the originating document via the Window.opener property (see About rel=noopener for more details), while still providing the Referer HTTP header (unless noreferrer is used as well).

Note that when noopener is used, nonempty target names other than _top, _self, and _parent are all treated like _blank in terms of deciding whether to open a new window/tab.

 <a>, <area> <link>
noreferrer

Prevents the browser, when navigating to another page, to send this page address, or any other value, as referrer via the Referer: HTTP header.
(In Firefox, before Firefox 37, this worked only in links found in pages. Links clicked in the UI, like "Open in a new tab" via the contextual menu, ignored this).

 <a>, <area> <link>
pingback Defines an external resource URI to call if one wishes to make a comment or a citation about the webpage. The protocol used to make such a call is defined in the Pingback 1.0 specification.

Note: if the X-Pingback: HTTP header is also present, it supersedes the <link> element with this link type.		 <link> <a>, <area>
preconnect Provides a hint to the browser suggesting that it open a connection to the linked web site in advance, without disclosing any private information or downloading any content, so that when the link is followed the linked content can be fetched more quickly. <link> <a>, <area>
prefetch Suggests that the browser fetch the linked resource in advance, as it is likely to be requested by the user. Starting with Firefox 44, the value of the crossorigin attribute is taken into consideration, making it possible to make anonymous prefetches.

Note: The Link Prefetch FAQ has details on which links can be prefetched and on alternative methods.		 <a> Unimplemented,
<area> Unimplemented,
<link> 		None.
preload Tells the browser to download a resource because this resource will be needed later during the current navigation. See Preloading content with rel="preload" for more details. <link> <a>, <area>
prerender Suggests that the browser fetch the linked resource in advance, and that it also render the prefetched content offscreen so it can be quickly presented to the user once needed. <link> <a>, <area>
prev Indicates that the hyperlink leads to the preceding resource of the sequence the current page is in.

Note: You can also use the next keyword to specify a link to the next page in the sequence.

Although recognized, the synonym previous is incorrect and must be avoided.		 <a>, <area>, <link> None.
stylesheet Defines an external resource to be used as a stylesheet. If the type is not set, the browser should assume it is a text/css stylesheet until further inspection.

If used in combination with the alternate keyword, it defines an alternative style sheet; in that case the title attribute must be present and not be the empty string.		 <link> <a>, <area>
tag Indicates that the hyperlink refers to a document describing a tag that applies to this document.

Note: This link type should not be set on links to a member of a tag cloud as these do not apply to a single document but to a set of pages.		 <a>, <area> <link>
up Indicates that the page is part of a hierarchical structure and that the hyperlink leads to the higher level resource of that structure.

The number of up link types indicates the depth difference between the current page and the linked resource.		 <a>, <area>, <link> None.

Specifications

Specification Status Comment
Preload
The definition of 'preload' in that specification.		 Working Draft Added preload.
Resource Hints
The definition of 'preconnect' in that specification.		 Working Draft Added dns-prefetch, preconnect, and prerender values.
HTML Living Standard
The definition of '<link>' in that specification.		 Living Standard No change since last snapshot (HTML Living Standard)
HTML5
The definition of '<link>' in that specification.		 Recommendation Added tag, stylesheet, search, prev, prefetch, noreferrer, nofollow, next, license, icon, help, bookmark, author, and alternate.
HTML 4.01 Specification
The definition of '<link>' in that specification.		 Recommendation

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
Alternative stylesheets ? 3.0 (1.9) ? (Yes) ?
prefetch ? ? ? ? ?
prerender ? No support[4] ? ? ?
preconnect 46 39 (39)[1] No support ? No support
dns-prefetch 46 3.0 (1.9) ? ? ?
preload 50.0 No support[3] ? (Yes) (Yes)
noopener 49.0 52 (52) ? 36 ?
manifest No support[2]
Feature Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support (Yes) (Yes) 1.0 (1.0) (Yes) (Yes) (Yes) (Yes)
Alternative stylesheets ? ? 4.0 (2.0) ? ? ? ?
prefetch No support ? ? ? ? ? ?
prerender ? ? No support[4] ? ? ? ?
preconnect 46 ? 39.0 (39) ? ? ? 42.0[1]
dns-prefetch 46 ? 1.0 (1.9) ? ? ? (Yes)
preload No support 50.0 No support[3] ? (Yes) ? 50.0
noopener No support 49.0 ? ? 32 ? 49.0
manifest No support 39.0 39.0

[1] Before Firefox 41, it didn't obey the crossorigin attribute.

[2] Since this is a mobile feature, desktop ignores it rather than throwing an error.

[3] This feature was available in Firefox 56, but only for cacheable resources. It has been disabled in Firefox 57 because of various web compatibility issues (e.g. bug 1405761). An improved version that works for non-cacheable resources is expected to land in Firefox 59.

[4] This was implemented behind a pref in Gecko 53 — dom.linkPrerender.enabled.— but then removed because of lack of uptake and removal in Chromium. See bug 1383876.

Edit this page on MDN

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types