existing-rel-values
This article is actively undergoing a major edit for a short while. As a courtesy, please do not edit this page while this message is displayed. The user who added this notice will be listed in the page history. If this page has not been edited for over an hour, please remove this template. This message is intended to help reduce edit conflicts; please remove it between editing sessions to allow others to edit the page. |
existing rel values
This page contains tables of known rel values from specifications, formats, proposals, brainstorms, and non-trivial POSH usage in the wild. In addition, dropped and rejected values are listed at the end for comprehensiveness.
Note: these lists may be incompleete, please help complete them from the referenced sources.
usage
See rel-faq#How_is_rel_used. Regarding rev, see: rel-faq#Should_rev_even_be_used.
formats
These rel values are defined formats from specifications (HTML 4, microformats) are thus are recommended for general use. Alphabetically ordered by value.
Sources:
- HTML 4 link type
- xfn and other microformats
| rel value | summary (from the relevant specification where possible)) |
defining specification |
|---|---|---|
| acquaintance | the person represented by the current document considers the person represented by the referenced document to be an acquaintance | XFN |
| alternate | Designates substitute versions for the document in which the link occurs. When used together with the lang attribute, it implies a translated version of the document. When used together with the media attribute, it implies a version designed for a different medium (or media). |
HTML4 link type |
| appendix | Refers to a document serving as an appendix in a collection of documents. | HTML4 link type |
| bookmark | Refers to a bookmark. A bookmark is a link to a key entry point within an extended document. The title attribute may be used, for example, to label the bookmark. Note that several bookmarks may be defined in each document. |
HTML4 link type |
| chapter | Refers to a document serving as a chapter in a collection of documents. | HTML4 link type |
| child | the referenced person is a child of the person represented by the current document | XFN |
| colleague | the referenced person is a colleague of the person represented by the current document | XFN |
| contact | the person represented by the current document considers the person represented by the referenced document to be a contact | XFN |
| contents | Refers to a document serving as a table of contents. Some user agents also support the synonym ToC (from "Table of Contents"). | HTML4 link type |
| copyright | Refers to a copyright statement for the current document. | HTML4 link type |
| co-resident | the referenced person lives in the same residence as the person represented by the current document | XFN |
| co-worker | the referenced person is a co-worker of the person represented by the current document | XFN |
| crush | this person considers the referenced person to be a crush (i.e. has a crush on the referenced person) | XFN |
| date | this person considers the referenced person to be a date (i.e. is dating the referenced person) | XFN |
| friend | the person represented by the current document considers the person represented by the referenced document to be a friend | XFN |
| glossary | Refers to a document providing a glossary of terms that pertain to the current document. | HTML4 link type |
| help | Refers to a document offering help (more information, links to other sources information, etc.) | HTML4 link type |
| home | …indicates that the [referenced document] is the homepage of the site in which the current page appears. | rel-home |
| index | Refers to a document providing an index for the current document. | HTML4 link type |
| kin | the referenced person is part of the extended family of the person represented by the current document | XFN |
| license | …indicates that the [referenced document] is a license for the current page. | rel-license |
| me | the referenced document represents the same person as does the current document | XFN |
| met | this person has met the referenced person | XFN |
| muse | the referenced person inspires the person represented by the current document | XFN |
| neighbor | the referenced person lives nearby the person represented by the current document | XFN |
| next | Refers to the next document in a linear sequence of documents. User agents may choose to preload the "next" document, to reduce the perceived load time. | HTML4 link type |
| nofollow | …indicates that the destination of that hyperlink SHOULD NOT be afforded any additional weight or ranking by user agents which perform link analysis upon web pages (e.g. search engines). | rel-nofollow |
| parent | the referenced person is a parent of the person represented by the current document | XFN |
| prev | Refers to the previous document in an ordered series of documents. Some user agents also support the synonym "Previous". | HTML4 link type |
| previous | Synonym of prev |
HTML4 link type |
| section | Refers to a document serving as a section in a collection of documents. | HTML4 link type |
| sibling | the referenced person is a sibling of the person represented by the current document | XFN |
| spouse | the referenced person is a spouse of the person represented by the current document | XFN |
| sweetheart | this person considers the referenced person to be their sweetheart | XFN |
| start | Refers to the first document in a collection of documents. This link type tells search engines which document is considered by the author to be the starting point of the collection. | HTML4 link type |
| stylesheet | a style sheet for the current document | HTML4 link type |
| subsection | Refers to a document serving as a subsection in a collection of documents. | HTML4 link type |
| tag | …indicates that the [referenced document] is an author-designated "tag" (or keyword/subject) for the current page. | rel-tag |
| toc | Synonym of contents (from "Table Of Contents") |
HTML4 link type |
notes
rel="alternate"can take further meaning from additional attributes, such asrel="alternate" lang="fr"(French language version of this page)rel="alternate" media="print"(printable version of this page)rel="alternate" media="handheld"(version of the page intended or better for handheld/portable devices like PDAs, cell phones, etc.)
- Synonyms such as "previous", "toc" are not as widely supported as the main term.
proposals
A few rel values have been developed as drafts as a result of going through most of the microformats process, and are thus listed here for your serious consideration. You may use these values, and if you find any problems with them please point them out on the respective "issues" page for the rel value.
| rel value | summary | proposed in |
|---|---|---|
| directory | …indicates that the destination of the hyperlink is a directory listing containing an entry for the current page. | rel-directory |
| enclosure | …indicates that the destination of that hyperlink is intended to be downloaded and cached. | rel-enclosure |
| payment | ... | rel-payment |
brainstorming
Several rel values are being brainstormed as potential microformats and are thus listed here. If you find you have a use for such semantics in real world examples, consider trying out these values and provide feedback on the respective brainstorming page(s) with your results and experiences.
| rel value | summary | brainstormed in |
|---|---|---|
| cite | indicate[s] that the destination of that hyperlink is an authoritative source or a precedent to the current page. | distributed-conversation-brainstorming |
| group | the referenced document represents a group to which the person represented by the current document belongs | group-brainstorming |
| member | the referenced document represents a member of the group represented by the current document | group-brainstorming |
| product | … | product |
| profile | … | xmdp-brainstorming |
POSH usage
There are numerous rel values used as POSH, both in the wild, whose origins are not necessarily known, nor are their meanings consistent. There are also numerous rel values from external proposals of varying degrees of merit. It is useful to document their existence and summarize their implied meanings/usage intent as research that may be used to perhaps take one or more of them thru the microformats process if there is both sufficient interest and sufficient in the wild usage.
Note: this list is incomplete, please help complete it from the following sources:
External sources:
- Meta Information in DevMo Docs (DevMo)
- Microsummary
- Web Communication Link Relationships (WCLR)
- W3C Link Relationship values draft (LRdraft) - from a draft of the HTML spec circa 1991.
| rel value | summary | origin | proposal(s) |
|---|---|---|---|
| archive | index of archived entries | unknown, perhaps Wordpress open source blogging software | WCLR |
| author | ... | unknown | DevMo |
| comment | … | ... | WCLR |
| contribution | … | ... | WCLR |
| endorsed | … | ... | WCLR |
| feed | … | ... | WCLR |
| made | ... | ... | LRdraft |
| microsummary | … | ... | Microsummary, be aware of: microsummary issues |
| permalink | … | ... | WCLR |
| pingback | … | ... | WCLR |
| referral | … | ... | WCLR |
| related | … | ... | WCLR |
| resource | … | ... | WCLR |
| search | … | unknown | unknown |
| sponsor | … | ... | WCLR |
| trackback | … | unknown, perhaps open source Movable Type blogging software | WCLR |
| unendorsed | … | ... | WCLR |
| user | … | ... | WCLR |
| via | … | ... | WCLR |
dropped
The following rel values were in earlier version(s) of specification(s) and it is presumed by their absence from the most recent version of the respective specification(s) that they have been deprecated or obsoleted. Use of them could be considered a bit more standard than just POSH, although you may wish to research why such values were omitted from latter specifications before using them. If you do discover the reasoning, please add a short statement or link to thereof into the appropriate place in the following table.
Sources: HTML3 (expired!) - (has been superceded by HTML 3.2 - which itself has been superceded by HTML 4.0 - which itself has been updated by HTML 4.01, commonly referred to as "HTML 4" in this wiki and other places.)
| rel value | summary | defining specification | why dropped |
|---|---|---|---|
| banner | Was used to reference another document to be used as banner for this document (i.e. a form of "include" statement). | HTML 3 | unknown |
| up | When the document forms part of a hierarchy, this link references the immediate parent of the current document. | HTML 3 | unknown |
rejected
Some rel values have been proposed and rejected. These are not recommended for use, and listed here to make that explicit.
Source: rejected-formats.
| rel value | origin / proposal | why rejected |
|---|---|---|
| pavatar | pavatar | rejected-formats#Pavatar |
unspecified
Some rel values have been added to this page perhaps in one of the tables above, but no examples, nor an actual specification explicitly stating that the value(s) should be used in the HTML4 'rel' attribute could be found. They are listed here in the hopes someone can discover more specific/precise URLs to examples or specifications about them (preferably both), until then, they are strictly theoretical.
| rel value | summary | possible source |
|---|---|---|
| schema.DC | … | Dublin Core |
| schema.DCTERMS | … | Dublin Core |
tools
See implementations.