A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.
To request an account, ask an autoconfirmed user on Chat (such as one of these permanent autoconfirmed members).
RelExtensions
This page lists the allowed extension values for the rel="" attribute in HTML5. You may add your own values to this list, which makes them legal HTML5 rel values. We ask that you try to avoid redundancy; if someone has already defined a value that does roughly what you want, please reuse it. Note that rel tokens are ASCII-lowercase before comparison against canonical value, so the canonical values should be listed without uppercase ASCII letters.
Keyword | Effect on... | Brief description | Link to more details | Synonyms | Status | |
---|---|---|---|---|---|---|
link | a and area | |||||
accessibility | hyperlink | hyperlink | The linked document contains accessibility information for the linking document. | Bruce Lawson | Proposal | |
acquaintance | hyperlink | hyperlink | the person represented by the current document considers the person represented by the referenced document to be an acquaintance | XFN | Accepted | |
alternate | See HTML5 | |||||
archives | See HTML5 | |||||
author | See HTML5 | |||||
bookmark | See HTML5 | |||||
canonical | hyperlink | not allowed | Robots (e.g., search engines) should treat the document containing the tag as a minor variation of the linked document, which may result in the removal of the former from a web index and in the consolidation of its quality signals in the latter. | [1] | Proposal | |
canonical-domain | external resource | not allowed | More than one domain may have largely similar or identical content but only one of the domains should be indexed for search engines. E.g., a company may have short and long domain names for the same content.
For security against traffic theft, rev must be meaningless. |
Google's analogous service and Talk for this page | Proposal | |
canonical-first | external resource | hyperlink | Where the canonical value should point to a group of pages, but the link can point to only one page, the group of pages can be clarified by choosing the first page in the group and assigning the URL for this rel link.
For security against traffic theft, rev must be meaningless. This is only shorthand for providing two link elements, one on the noncanonical page to a "canonical" page and the other on the canonical page to the "first" page of the group. Where the group of pages corresponds to a subdirectory and a canonical URL value can point to the subdirectory resulting in a user arriving at the subdirectory's index page which is part of the group, this shorthand is unnecessary and one rel="canonical" will suffice. |
Talk for this page | Proposal | |
canonical-wwwnone | external resource | hyperlink | Both bare and www-prefixed domain names usually direct to the same site. Especially when external links to a site vary in the form used, search engine indexing concentrated on only one domain form may raise its credibility. The rel value is the form preferred for indexing, e.g., rel="http://example.net". Nothing to the right of the top-level domain is needed.
For security against traffic theft, rev must be meaningless. |
Google's analogous service and Talk for this page | Proposal | |
chapter | hyperlink | hyperlink | Target document is a subdocument of the current document. | HTML4 | section, subsection, appendix | Proposal |
child | hyperlink | hyperlink | the referenced person is a child of the person represented by the current document | XFN | Accepted | |
co-resident | hyperlink | hyperlink | the referenced person lives in the same residence as the person represented by the current document | XFN | Accepted | |
co-worker | hyperlink | hyperlink | the referenced person is a co-worker of the person represented by the current document | XFN | Accepted | |
colleague | hyperlink | hyperlink | the referenced person is a colleague of the person represented by the current document | XFN | Accepted | |
contact | hyperlink | hyperlink | the person represented by the current document considers the person represented by the referenced document to be a contact | XFN | Accepted | |
contributor | hyperlink | hyperlink | The linked document is the page/email an agent (people or firm or...) involved in the production of the content, but not his main author(s). | Proposal | ||
crush | hyperlink | hyperlink | this person considers the referenced person to be a crush (i.e. has a crush on the referenced person) | XFN | Accepted | |
date | hyperlink | hyperlink | this person considers the referenced person to be a date (i.e. is dating the referenced person) | XFN | Accepted | |
details | hyperlink | hyperlink | The referenced document contains additional (or complete) details about the current document (for example, a "read more..." hyperlink on a blog page that leads to the full posting). | Proposal | ||
dns-prefetch | external resource | not allowed | Force the DNS lookup of specific hostnames. | Mozilla DNS Prefetching, Chromium DNS Prefetching |
Proposal | |
edit | hyperlink | hyperlink | Target document is an editable version of the current document. | Atom Protocol | Proposal | |
edituri | hyperlink | not allowed | a link to an RSD file describing how to edit the given page. | rsd | Proposal | |
enclosure | hyperlink | hyperlink | the destination of the hyperlink is intended to be downloaded and cached. | rel-enclosure | Proposal | |
external | See HTML5 | |||||
feed | See HTML5 | |||||
first | See HTML5 | |||||
friend | hyperlink | hyperlink | the person represented by the current document considers the person represented by the referenced document to be a friend | XFN | Accepted | |
glossary | hyperlink | hyperlink | Target document provides definitions for words in current document. | HTML4 | Proposal | |
help | See HTML5 | |||||
hub | hyperlink | not allowed | Indicates a URL which implements both sides of the PubSubHubbub protocol. | PubSubHubbub | Proposal | |
i18nrules | hyperlink | not allowed | Target document provides ITS (Internationalization tag Set) rules for processing the current document. | ITS | Proposal | |
icon | See HTML5 | |||||
index | See HTML5 | |||||
jump | not allowed | hyperlink | Indicates a same page jump from the current fragment to another fragment. (E.g. sometimes online newspapers insert direct text saying "article continues below the image/advert" - they could instead use "jump" link. Ultimately, it indicates a page internal link.) | none | Proposal | |
kin | hyperlink | hyperlink | the referenced person is part of the extended family of the person represented by the current document | XFN | Accepted | |
last | See HTML5 | |||||
license | See HTML5 | |||||
logout | external resource | not allowed | The linked document provides a resource for the UA to request when all currently open documents of the same "group" are closed (to facilitate logging out the current user). | LogoutRelExtension | Proposal | |
me | hyperlink | hyperlink | the referenced document represents the same person as does the current document | XFN | Accepted | |
met | hyperlink | hyperlink | this person has met the referenced person | XFN | Accepted | |
muse | hyperlink | hyperlink | the referenced person inspires the person represented by the current document | XFN | Accepted | |
neighbor | hyperlink | hyperlink | the referenced person lives nearby the person represented by the current document | XFN | Accepted | |
next | See HTML5 | |||||
next-archive | hyperlink | hyperlink | A URI that refers to the immediately following archive document. | Atom Link Relations, RFC5005 |
Proposal | |
nofollow | See HTML5 | |||||
noreferrer | See HTML5 | |||||
openid.delegate | external resource | not allowed | OpenID 1.1 authentication delegation | OpenID specification | Proposal | |
openid.server | external resource | not allowed | OpenID 1.1 authentication delegation | OpenID specification | Proposal | |
openid2.local_id | external resource | not allowed | OpenID 2.0 authentication delegation | OpenID Auth 2.0 section 7.3.3 | Proposal | |
openid2.provider | external resource | not allowed | OpenID 2.0 authentication endpoint | OpenID Auth 2.0 section 7.3.3 | Proposal | |
parent | hyperlink | hyperlink | the referenced person is a parent of the person represented by the current document | XFN | Accepted | |
payment | hyperlink | hyperlink | A URI where payment is accepted. | Atom Link Relations | Proposal | |
pgpkey | hyperlink | not allowed | The linked document is the PGP public key file (which may contain multiple keys) of the author(s) of the page. | [2], [3] | Proposal | |
pingback | See HTML5 | |||||
prefetch | See HTML5 | |||||
prev | See HTML5 | |||||
prev-archive | hyperlink | hyperlink | A URI that refers to the immediately preceding archive document. | Atom Link Relations, RFC5005 |
Proposal | |
external resource | hyperlink | The referenced document is recommended for printing, even though the referent document is capable of being printed and both documents are of the same type, medium, and language. A typical case is where content spread over multiple pages is also available on a single page that is more convenient to print.
This is semantically more specific than "canonical" and "alternate". Where type, medium, and/or language differ, consider "alternate"; where any of them differ but the purpose is printing, consider applying both values. |
W3C Bug 7645 | Proposal | ||
profile | hyperlink | hyperlink | this referenced link is a metadata profile for the current document | HTML Meta data profiles, Example of profile in a-elements |
Proposal | |
pronunciation | external resource | hyperlink | The referenced document offers one or more pronunciations to aid text-to-speech (TTS) synthesis software, especially for unusual and new words. The referenced document can be in any format that supports the functionality, including *.pls. | W3C Bug 7601 as HTML5 proposal and Pronunciation Lexicon Specification (PLS) 1.0 | Proposal | |
related | hyperlink | hyperlink | this referenced link identifies a resource related to the current document | Atom Syndication Format | Proposal | |
reviewer | hyperlink | not allowed | The linked document is the page/email an agent (people or firm or...) responsible for reviewing the content. | [4] | Proposal | |
script | not allowed | not allowed | Was proposed to replace <script>. Use <script> instead. | none | Rejected | |
search | See HTML5 | |||||
self | hyperlink | hyperlink | A URI that refers to a resource equivalent to the containing element. | Atom Link Relations, RFC4287 |
Proposal | |
service | external resource | not allowed | Points to a resource describing a service API | ServiceRelExtension | Proposal | |
shortlink | hyperlink | hyperlink | Identifies a shorter form of the URL for the current document, provided by the document owner. | shortlink Specification | Proposal | |
sibling | hyperlink | hyperlink | the referenced person is a sibling of the person represented by the current document | XFN | Accepted | |
sidebar | See HTML5 | |||||
spouse | hyperlink | hyperlink | the referenced person is a spouse of the person represented by the current document | XFN | Accepted | |
stylesheet | See HTML5 | |||||
sweetheart | hyperlink | hyperlink | this person considers the referenced person to be their sweetheart | XFN | Accepted | |
tag | See HTML5 | |||||
technicalauthor | hyperlink | hyperlink | The linked document is the page/email an agent (people or firm or...) responsible for the technical construction of the page (i.e. the HTML/CSS/PHP code), not for the content. | Proposal | ||
timesheet | external resource | not allowed | SMIL Timesheet | SMIL Timesheets 1.0 | Proposal | |
translatedfrom | hyperlink | hyperlink | The linked document is the page/email that has been translation source for the current document. It also indicates that the current document is a translation and not an original work. | Proposal | ||
translator | hyperlink | hyperlink | The linked document is the page/email an agent (people or firm or...) responsible for the translation of the page. It also indicates that the current page is a translation of an other document, which should be linked through a rel="translatedfrom". | Proposal | ||
up | See HTML5 | |||||
webmaster | hyperlink | hyperlink | The linked document is the page/email an agent (people or firm or...) available for requests about the content of the page. | maintainer | Proposal | |
widget | hyperlink | hyperlink | Points to a widget. | Widgets 1.0 Editor's draft | Proposal | |
wlwmanifest | hyperlink | not allowed | A link to a manifest for Windows Live Writer. | msdn | Proposal |
The "Effect on... link" column must either say "not allowed" if the rel value is not allowed on <link> elements, "hyperlink" if the rel value creates a hyperlink, or "external resource" if the rel value creates a link to an external resource.
The "Effect on... a and area" column must either say "not allowed" or "hyperlink".
For the "Status" section to be changed to "Accepted", the proposed keyword must either have been through the Microformats process, and been approved by the Microformats community; or must be defined by a W3C specification in the Candidate Recommendation or Recommendation state. If it fails to go through this process, it is "Rejected".
For more details, see the HTML5 specification. See also the Microformats wiki page on this matter.