existing-rel-values: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (Fix: replaces deprecated <source> tag with <syntaxhighlight>)
(219 intermediate revisions by 97 users not shown)
Line 1: Line 1:
<entry-title> existing rel values </entry-title>
{{DISPLAYTITLE: existing rel values }}


This page contains tables of known HTML 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.
This page contains tables of known HTML 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.


<span id="usage">usage</span>: see [[rel-faq#How_is_rel_used|how is 'rel' used]].  Regarding <span id="rev">rev</span>, see: [[rel-faq#Should_rev_even_be_used|should 'rev' even be used]].
<span id="usage">usage</span>: see [[rel-faq#How_is_rel_used|how is 'rel' used]].  Regarding <span id="rev">rev</span>, see: [[rel-faq#Should_rev_even_be_used|should 'rev' even be used]].
This page is also the official rel registry ([https://html.spec.whatwg.org/multipage/links.html#other-link-types WHATWG HTML] ([http://www.whatwg.org/specs/web-apps/current-work/multipage/links.html#other-link-types original link]), [http://www.w3.org/TR/html5/links.html#other-link-types W3C HTML5]). Add new and proposed rel values to the following section:
* [[existing-rel-values#HTML5_link_type_extensions|HTML5 link type extension]]


== formats ==
== formats ==
Line 69: Line 73:
|-
|-
| [[rel-child|child]]
| [[rel-child|child]]
| not allowed
| external relation
| external relation
| the referenced person is a child of the person represented by the current document
| external relation
| [[XFN]]
| The referenced person is a child of the person represented by the current document. It may also indicate that the target document is a hierarchical child, or subdocument, of the current document.
| [[XFN]], [https://www.w3.org/TR/relations.html HTML 4.0 Specification]


|-
|-
Line 141: Line 145:
| allowed
| allowed
| allowed
| allowed
| Refers to a document providing a glossary of terms that pertain to the current document.||[http://www.w3.org/TR/html4/types.html#h-6.12 HTML4 Link types]
| Refers to a document providing a list of terms and their definitions that pertain to the current document.||[http://www.w3.org/TR/html4/types.html#h-6.12 HTML4 Link types]


|-
|-
Line 149: Line 153:
| Refers to a document offering help (more information, links to other sources information, etc.)
| Refers to a document offering help (more information, links to other sources information, etc.)
| [http://www.w3.org/TR/html4/types.html#h-6.12 HTML4 Link types]
| [http://www.w3.org/TR/html4/types.html#h-6.12 HTML4 Link types]
|-
| [[rel-its-rules|its-rules]]
| allowed
| not allowed
| Refers to a document with external ITS rules.
| [http://www.w3.org/TR/its20/#selection-global-html5 Internationalization Tag Set (ITS) Version 2.0]


|-
|-
Line 208: Line 219:
|-
|-
| [[rel-parent|parent]]
| [[rel-parent|parent]]
| not allowed
| external relation
| external relation
| the referenced person is a parent of the person represented by the current document
| external relation
| [[XFN]]
| The referenced person is a parent of the person represented by the current document. It may also indicate that the target document is the hierarchical parent, or container, of the current document.
| [[XFN]], [https://www.w3.org/TR/relations.html HTML 4.0 Specification]


|-
|-
Line 322: Line 333:
| [[rel-home|home]] || &hellip;indicates that the <nowiki>[referenced document]</nowiki> is the homepage of the site in which the current page appears. || [[rel-home]]
| [[rel-home|home]] || &hellip;indicates that the <nowiki>[referenced document]</nowiki> is the homepage of the site in which the current page appears. || [[rel-home]]
|-
|-
| [[rel-payment|payment]] || &hellip; || [[rel-payment]]
| [[rel-payment|payment]] || &hellip;indicates that the destination of the hyperlink provides a way to show or give support (e.g. financial) for the current page|| [[rel-payment]]
|-
| vcs-* || &hellip;indicates that the destination of the hyperlink is the location of a Version Control System repository related to that page.|| || [https://joeyh.name/rfc/rel-vcs/ rel=vcs-*]
|}
|}


== brainstorming ==
== HTML5 link type extensions ==
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, <strong>consider trying out</strong> these values and provide feedback on the respective brainstorming page(s) with your results and experiences.
 
The following values are registered as link type extensions per the [http://www.whatwg.org/specs/web-apps/current-work/multipage/links.html#other-link-types requirements in the WHATWG HTML spec] and the [http://www.w3.org/TR/html5/links.html#other-link-types requirements in the W3C HTML5 spec].
 
 
Before you register a new value:
* '''Please check the [[#formats|Formats table]] and DO NOT re-register''' rel values that are already there. Please note that the W3C HTML WG has made a [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Decision] to drop <code>index</code>, <code>up</code>, <code>first</code> and <code>last</code> from the HTML5 spec itself.
* '''Please check the [[#dropped|Dropped table]] and DO NOT register''' values that are already there. If you believe a rel value was dropped from another specification without prejudice, please provide link/cite to explicit text/decision stating as such, e.g. the value was merely postponed, or perhaps expected to be spun-out into its own spec from the group developing that specification.
 
Note that entries in the [[#formats|Formats table]] and entries that are already in HTML5 as built-in keywords are also considered extensions with the "Ratified" status.
 
Please make sure that registrations added here have all the required data filled in ''including'':
* "Effect on link"
* "Effect on a and area" and
* a link to a spec that documents the keyword ''as an HTML <code>rel</code> keyword''. (A spec that merely defines the file format of the link target but does not define the <code>rel</code> keyword for use in HTML is not the kind of spec that is being required here.)
 
Entries lacking any of the above required data will likely be removed.  


You may list new proposed rel values here, and even better if you can list and link to POSH uses in the wild.
Changes to this registry will not be reflected in validators in real time. But validators will typically get automatically updated with the changes within one week or so


{| border="1"
{| border="1"
|+  
|+  
! rel value !! summary !! brainstormed in and usage in the wild
! Keyword
! Effect on <code>link</code>
! Effect on <code>a</code>, <code>area</code>
! Brief description
! Link to specification
! Synonyms
! Status


|-
| [[rel-accessibility|accessibility]] || indicate[s] that the destination of that hyperlink contains accessibility information for the current page. || [http://www.brucelawson.co.uk/2009/rel-accessibility/ blog post] which itself uses the rel value in a &lt;link&gt; tag in the head of the document.


|-
|-
| [[rel-author|author]] || indicate[s] that the destination of that hyperlink represents the author of the current page. Combines with [[rel-me|rel-me]] to chain authorship information. || Google has said it will index rel-Author in this [http://googlewebmastercentral.blogspot.com/2011/06/authorship-markup-and-web-search.html blog post], with further [http://www.google.com/support/webmasters/bin/answer.py?answer=1229920 discussion of the rel-me connection] See also [http://dev.w3.org/html5/spec/Overview.html#link-type-author the HTML5 spec]
| [[rel-about|about]]
 
| Hyperlink
| Hyperlink
| The resource linked to contains information about the current page.
| [https://www.rfc-editor.org/rfc/rfc6903.html#section-2 RFC6903]
| It might combine with [[rel-me]] or [[rel-author]] in links to an "about" section focused on an author
| proposed


|-
|-
| [[rel-bibliography|bibliography]] || indicate[s] that the destination of that hyperlink is a bibliography for the current page. || [http://microformats.org/discuss/mail/microformats-discuss/2007-October/010863.html mailing list post, 2007-10-15]
| [[rel-amphtml|amphtml]]
| Hyperlink
| Hyperlink
| Specify an alternate version of the document written in AMP HTML
| [https://github.com/ampproject/amphtml AMP HTML documentation]
| could be combined with rel=alternate
| proposed


|-
|-
| [[rel-cite|cite]] || indicate[s] that the destination of that hyperlink is an authoritative source or a precedent to the current page. || [[distributed-conversation-brainstorming]]
| [[rel-apple-touch-icon|apple-touch-icon]]
| External Resource
| Not allowed
| Specify a Webpage Icon for a “Web Clip”, or “touch icon”, for mobile devices (not limited to Apple devices).
| [http://developer.apple.com/library/safari/#documentation/appleapplications/reference/safariwebcontent/configuringwebapplications/configuringwebapplications.html Apple's Safari Web Content Guide]
| probably redundant with rel=icon
| proposed


|-
|-
| [[rel-group|group]] || the referenced document represents a group to which the person represented by the current document belongs || [[group-brainstorming]]
| [[rel-apple-touch-icon-precomposed|apple-touch-icon-precomposed]]
 
| External Resource
| Not allowed
| Specify a Webpage Icon for a “Web Clip”, or “touch icon”, for mobile devices (not limited to Apple devices).
| [http://developer.apple.com/library/safari/#documentation/appleapplications/reference/safariwebcontent/configuringwebapplications/configuringwebapplications.html Apple's Safari Web Content Guide]
| probably redundant with rel=icon
| proposed


|-
|-
| <span id="longdesc">[[rel-longdesc|longdesc]]</span> || Alternative to the img longdesc attribute, for use on visible links || [http://www.google.com/search?q=rel%3D%22longdesc%22 Google search for rel=longdesc in the wild] shows many sources of proposals. Please edit this to list the earliest and perhaps most recent/comprehensive proposal. No known real world POSH usage in the wild yet.
| [[rel-apple-touch-startup-image|apple-touch-startup-image]]  
| External Resource
| Not allowed
| Specify a splashscreen for Web apps on iOS Safari
| [http://developer.apple.com/library/safari/#documentation/appleapplications/reference/safariwebcontent/configuringwebapplications/configuringwebapplications.html Apple's Safari Web Content Guide]
| maybe redundant with rel=icon with the sizes attribute?
| proposed


|-
|-
| [[rel-map|map]] || Link to a map. Possibly embedded within an adr, hCard, geo or hCalendar. Parsers {{may}} attempt to parse the URL if it is a link to a known map site (e.g. Geohash, Google Maps, Multimap) and extract co-ordinates and other useful data. || (to [[User:TobyInk|TobyInk]] by email)
| [[rel-archived|archived]]
| External Resource
| Hyperlink Annotation
| The target resource is archived and kept largely or solely for historical purposes.
| [https://sitemorse.com/rel-archived/ rel="archived" description]
|
| proposed


|-
|-
| [[rel-member|member]] || the referenced document represents a member of the group represented by the current document || [[group-brainstorming]]
| [[rel-attachment|attachment]]
| Hyperlink
| Hyperlink
| The resource linked to is "attached" to this document, similar to email attachments. Used in WordPress.
| No formal specification
|
| proposed


|-
|-
| [[rel-product|product]] || &hellip; || [[product-brainstorming]]
| [[rel-authorization_endpoint|authorization_endpoint]]  
| External Resource
| Not allowed
| Specify a hosted authorization server
| [https://www.w3.org/TR/indieauth/ IndieAuth spec]
|
| proposed


|-
|-
| [[rel-profile|profile]] || indicate[s] that the destination of that hyperlink is a metadata profile (e.g. an [[XMDP]] profile) for the current page or portion thereof || [[xmdp-brainstorming]]
| [[rel-canonical|canonical]]
| Hyperlink
| Hyperlink
| Specifies the canonical URL for the current document in order to help avoid duplicate content.
| [http://en.wikipedia.org/wiki/Canonical_meta_tag Canonical meta tag] [http://www.Google.com/support/webmasters/bin/answer.py?answer=139066#2 Canonicalization at Google Webmaster Central] [http://www.Bing.com/community/site_blogs/b/webmaster/archive/2009/02/12/partnering-to-help-solve-duplicate-content-issues.aspx Microsoft Webmaster Center] [http://www.YSearchBlog.com/2009/02/12/fighting-duplication-adding-more-arrows-to-your-quiver/ Yahoo! Search Blog]
|
| proposed


|-
|-
| [[rel-shortlink|shortlink]] || the referenced document represents the current document but with a shorter URL || [http://samj.net/2009/04/introducing-relshort-better-alternative.html blog post]
| [[rel-category|category]]
| Hyperlink
| Hyperlink
| Refers to a category assigned to the current document or post. Implemented by WordPress for indicating a relation between a blog post and a category.
| [[rel-category]]
|
| proposed


|-
|-
| vcalendar-parent || link from an event to a containing event || [[User:TobyInk/hcalendar-1.1|hCalendar 1.1 draft]]
| [[rel-code-repository|code-repository]]
|-
| Hyperlink
| vcalendar-child || link from an event to a contained event || [[User:TobyInk/hcalendar-1.1|hCalendar 1.1 draft]]
| Hyperlink
|-
| indicates a code repository location. For link, it specifically indicates, in the case of server-generated content, the location of source code responsible for the generation of the current page, or, in the case of static files, where copies of the current page are housed). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the generator and [[rel-content-repository|content-repository]] should be used to indicate the location for the storage of content. Otherwise, the code repository can be considered as also including the content. While the repository should contain its own license file, the [[rel-code-license|code-license]] rel-value is proposed as a direct pointer to the license (see also [[rel-content-license|content-license]]).
| vcalendar-sibling || link from an event to a related event with the same container || [[User:TobyInk/hcalendar-1.1|hCalendar 1.1 draft]]
|
|
| proposed


|-
|-
| [[rel-status|status]] || the referenced document represents the status (or source of status updates) for the author of this document || [http://www.monkinetic.com/2009/11/status-autodiscovery-relstatus.html blog post]
| [[rel-code-license|code-license]]
| Hyperlink
| Hyperlink
| indicates a license for code (a proposed broader replacement for [[rel-jslicense|jslicense]]). For link, it specifically indicates, in the case of server-generated content, the location of the license for all source code responsible for the generation of the current page, or, in the case of static files, the location of the license for all of these files). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the generator and [[rel-content-license|content-license]] should be used to indication the license for the content. Otherwise, code-license can be considered as also covering the license of the content. Pointing to the repository containing the static or generator code files should be done with [[rel-code-repository|code-repository]] (and [[rel-content-repository|content-repository]] for any separate content).
|
|
| proposed


|}


=== more brainstorming ===
|-
See also:
| [[rel-component|component]]  
* [[genealogy-brainstorming]] for some thoughts on possible additional values for family relationships (use existing [[XFN]] [[rel-parent|parent]], [[rel-child|child]], [[rel-sibling|sibling]], [[rel-spouse|spouse]], [[rel-kin|kin]] values first though)
| External Resource
* [[xpn-brainstorming]] for some thoughts on possible additional values for professional relationships (use existing [[XFN]] [[rel-co-worker|co-worker]], [[rel-colleague|colleague]] values first though)
| Not allowed
| Specify an HTML document that is treated as a component of this document.
| [https://dvcs.w3.org/hg/webcomponents/raw-file/tip/spec/components/index.html Web Components]
|  
| proposed


== 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.
| [[rel-chrome-webstore-item|chrome-webstore-item]]  
| External Resource
| Not allowed
| Link tag to declare for app and extensions inline installations hosted in the Chrome Web Store.
| [https://developers.google.com/chrome/web-store/docs/inline_installation Using Inline Installation]
|
| proposed


Note: If a value is missing from this table, it may have either already been promoted by writing it up as a proposal, or demoted by being explicitly dropped. Please check the other tables first before adding to this table.
|-
| [[rel-content-repository|content-repository]]
| Hyperlink
| Hyperlink
| indicates a repository housing data content. For link, it specifically indicates, in the case of server-generated content, the location where separately housed data files used to populate the current page are stored (otherwise "code-repository" is sufficient to include content as well as code). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the data/content files and [[rel-code-repository|code-repository]] should be used to indicate the location for the storage of the generator source files. Otherwise, [[rel-code-repository|code-repository]] can be considered as also including the content instead. While the repository should contain its own license file, the [[rel-content-license|content-license]] rel-value is proposed as a direct pointer to the license (see also [[rel-code-license|code-license]]).
|
|
| proposed


Note: this list is incomplete, please help complete it from the following sources:
|-
| [[rel-content-license|content-license]]
| Hyperlink
| Hyperlink
| indicates a license for data content. For link, it specifically indicates, in the case of server-generated content, the location of the license for all separately housed data files used to populate the current page are stored, (otherwise "code-license" is sufficient to cover the license of content as well as code)). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the data/content files and [[rel-code-license|code-license]] should be used to indication the license for the generator source files. Otherwise, code-license can be considered as also covering the license of the content. Pointing to the repository containing the data files should be done with [[rel-content-repository|content-repository]] (and [[rel-code-repository|code-repository]] for the static or generator code files).
|
|
| proposed


External sources:
* [http://developer.mozilla.org/about/meta Meta Information in DevMo Docs] (DevMo)
* [http://wiki.mozilla.org/Microsummaries Microsummary]
* [http://lachy.id.au/dev/markup/specs/wclr/ Web Communication Link Relationships] (WCLR)
* [http://www.w3.org/MarkUp/Relationships.html W3C Link Relationship values draft] (LRdraft) - from a draft of the HTML spec circa 1991.
* [http://www.whatwg.org/specs/web-apps/current-work/multipage/section-links.html#linkTypes HTML5 draft] '''Liable to change'''
* [http://wiki.foaf-project.org/Autodiscovery FOAF Project Wiki: Autodiscovery] (FOAF)
* [http://www.apps.ietf.org/rfc/rfc4685.html RFC4685]
* [http://googlewebmastercentral.blogspot.com/2009/02/specify-your-canonical.html Google Blog]


|-
| [[rel-dcterms.(property)#conformsTo|DCTERMS.conformsTo]]
| External Resource
| Not allowed
| An established standard to which the described resource conforms. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.conformsTo" content="..." /></code>
| proposed


{| border="1"
|-
|+
| [[rel-dcterms.(property)#contributor|DCTERMS.contributor]]
! rel value !! summary !! origin !! proposal(s)
| External Resource
| Not allowed
| An entity responsible for making contributions to the resource. Examples include a person, an organization, or a service. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.contributor" content="..." /></code>
| proposed


|-
|-
| [[rel-archive|archive]] || index of archived entries || unknown, perhaps Wordpress open source blogging software || WCLR
| [[rel-dcterms.(property)#creator|DCTERMS.creator]]  
| External Resource
| Not allowed
| An entity primarily responsible for making the resource. Examples include a person, an organization, or a service. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.creator" content="..." /></code>
| proposed


|-
|-
| [[rel-archives|archives]] || Provides a link to a collection of records, documents, or other materials of historical interest. || || HTML5
| [[rel-dcterms.(property)#description|DCTERMS.description]]  
| External Resource
| Not allowed
| An account of the resource. Description may include but is not limited to: an abstract, a table of contents, a graphical representation, or a free-text account of the resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.description" content="..." /></code>
| proposed


|-
|-
|[[rel-author|author]]||see brainstorming above for suggested use by google||unknown || DevMo / HTML5
| [[rel-dcterms.(property)#hasFormat|DCTERMS.hasFormat]]  
| External Resource
| Not allowed
| A related resource that is substantially the same as the pre-existing described resource, but in another format.  <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-canonical|canonical]] || To help search engines disambiguate the same page with multiple representations || Google || [http://googlewebmastercentral.blogspot.com/2009/02/specify-your-canonical.html Google]/[http://www.bing.com/community/blogs/webmaster/archive/2009/02/12/partnering-to-help-solve-duplicate-content-issues.aspx Microsoft]/[http://www.ysearchblog.com/2009/02/12/fighting-duplication-adding-more-arrows-to-your-quiver/ Yahoo!], [http://blog.ask.com/2009/02/ask-is-going-canonical.html Ask Jeeves]
| [[rel-dcterms.(property)#hasPart|DCTERMS.hasPart]]  
| External Resource
| Not allowed
| A related resource that is included either physically or logically in the described resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-comment|comment]] || &hellip; || &hellip; || WCLR
| [[rel-dcterms.(property)#hasVersion|DCTERMS.hasVersion]]  
| External Resource
| Not allowed
| A related resource that is a version, edition, or adaptation of the described resource.  <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-contribution|contribution]] || &hellip; || &hellip; || WCLR
| [[rel-dcterms.(property)#isFormatOf|DCTERMS.isFormatOf]]  
| External Resource
| Not allowed
| A related resource that is substantially the same as the described resource, but in another format.  <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-edituri|EditURI]]  
| [[rel-dcterms.(property)#isPartOf|DCTERMS.isPartOf]]  
| Location of the xml-rpc gateway for a Wordpress install that allows external programs to add, edit and delete posts. Used by "[http://codex.wordpress.org/Weblog_Client WordPress blog client]" software for automating posting and updating blog content from your desktop. || Seen in [http://www.wordpress.org/ WordPress], e.g. [http://www.tom-watson.co.uk/]|| Description stubbed in [[rel-edituri]].
| External Resource
| Not allowed
| A related resource in which the described resource is physically or logically included.  <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-endorsed|endorsed]] || &hellip; || &hellip; || WCLR
| [[rel-dcterms.(property)#isReferencedBy|DCTERMS.isReferencedBy]]  
| External Resource
| Not allowed
| A related resource that references, cites, or otherwise points to the described resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-fan|fan]] || xxxx. || &hellip; || [[hcard-user-profile-authoring]]
| [[rel-dcterms.(property)#isReplacedBy|DCTERMS.isReplacedBy]]  
| External Resource
| Not allowed
| A related resource that supplants, displaces, or supersedes the described resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-feed|feed]] || Gives the address of a syndication feed for the current document. || &hellip; || WCLR/ HTML5
| [[rel-dcterms.(property)#isRequiredBy|DCTERMS.isRequiredBy]]  
| External Resource
| Not allowed
| A related resource that requires the described resource to support its function, delivery, or coherence. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-footnote|footnote]] || Location of the footnote on a link to a footnote. || Markdown preprocessors such as [http://maruku.rubyforge.org/ Maruku] || HTML5
| [[rel-dcterms.(property)#isVersionOf|DCTERMS.isVersionOf]]  
| External Resource
| Not allowed
| A related resource of which the described resource is a version, edition, or adaptation. <br />Changes in version imply substantive changes in content rather than differences in format. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-icon|icon]] || Imports an icon to represent the current document. (Allowed in <code>link</code> only) || [http://dev.w3.org/html5/spec-LC/links.html#rel-icon HTML5] || WCLR/HTML5
| [[rel-dcterms.(property)#license|DCTERMS.license]]  
| External Resource
| Not allowed
| A legal document giving official permission to do something with the resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.license" content="..." /></code>
| proposed


|-
|-
| [[rel-kinetic-stylesheet|kinetic-stylesheet]] || Imports a [http://kssproject.org/ KSS] 'kinetic stylesheet' to bind dynamic behavior to elements || Used in the [http://plone.org Plone] Content Management System || &hellip;
| [[rel-dcterms.(property)#mediator|DCTERMS.mediator]]  
| External Resource
| Not allowed
| An entity that mediates access to the resource and for whom the resource is intended or useful. In an educational context, a mediator might be a parent, teacher, teaching assistant, or care-giver. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.mediator" content="..." /></code>
| proposed


|-
|-
| [[rel-lightbox|lightbox]] || Hook - Indicates that following the link will trigger a "lightbox" script (Allowed in <code>link</code> only) || ([http://www.google.co.uk/search?q=rel%3D%22lightbox%22 Google search for rel=lightbox in the wild]) || &hellip;  
| [[rel-dcterms.(property)#publisher|DCTERMS.publisher]]  
| External Resource
| Not allowed
| An entity responsible for making the resource available. Examples include a person, an organization, or a service. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.publisher" content="..." /></code>
| proposed


|-
|-
| [[rel-prettyPhoto|prettyPhoto]] || See also "lightbox" || ([http://www.google.fr/search?q=rel%3D%22prettyphoto%22 Google search for rel="prettyphoto" in the wild]) || &hellip;
| [[rel-dcterms.(property)#references|DCTERMS.references]]  
| External Resource
| Not allowed
| A related resource that is referenced, cited, or otherwise pointed to by the described resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-made|made]] || &hellip; || &hellip; || LRdraft
| [[rel-dcterms.(property)#relation|DCTERMS.relation]]  
| External Resource
| Not allowed
| A related resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-meta|meta]] || &hellip; |[http://www.w3.org/TR/1999/REC-rdf-syntax-19990222/#transport 1999 W3C RDF syntax REC] || FOAF
| [[rel-dcterms.(property)#replaces|DCTERMS.replaces]]  
| External Resource
| Not allowed
| A related resource that is supplanted, displaced, or superseded by the described resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-microsummary|microsummary]]|| &hellip; || &hellip; ||[http://wiki.mozilla.org/Microsummaries Microsummary], be aware of: [[page-summary-formats#Issues_2|microsummary issues]]
| [[rel-dcterms.(property)#requires|DCTERMS.requires]]  
| External Resource
| Not allowed
| A related resource that is required by the described resource to support its function, delivery, or coherence. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-noreferrer|noreferrer]] || indicates that no referrer information is to be leaked when following the link. || [http://dev.w3.org/html5/spec-LC/links.html#rel-noreferrer HTML5] || HTML5
| [[rel-dcterms.(property)#rightsHolder|DCTERMS.rightsHolder]]  
| External Resource
| Not allowed
| A person or organization owning or managing rights over the resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
| It may be replaced by the literal value in form of <code>&lt;meta name="DCTERMS.rightsHolder" content="..." /></code>
| proposed


|-
|-
| [[rel-openid-delegate|openid.delegate]] || &hellip; || ([http://www.google.co.uk/search?q=%22rel%3Dopenid%22 Google search for rel=openid.* in the wild]) || &hellip;
| [[rel-dcterms.(property)#source|DCTERMS.source]]  
| External Resource
| Not allowed
| A related resource from which the described resource is derived. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-openid-server|openid.server]] || &hellip; || ([http://www.google.co.uk/search?q=%22rel%3Dopenid%22 Google search for rel=openid.* in the wild]) || &hellip;
| [[rel-dcterms.(property)#subject|DCTERMS.subject]]  
| External Resource
| Not allowed
| The topic of the resource. <br />
Requires Dublin Core namespace declaration: <code>'''&lt;link rel="schema.DCTERMS" href="<nowiki>http://purl.org/dc/terms/</nowiki>" />'''</code>
| [http://dublincore.org/documents/dcmi-terms/ DCMI Metadata Terms]
|
| proposed


|-
|-
| [[rel-permalink|permalink]] || &hellip; || &hellip; || WCLR
| [[rel-disclosure|disclosure]]
| Not allowed
| External Resource
| The 'disclosure' Link Relation Type designates a list of patent disclosures or a particular patent disclosure itself made with respect to material for which such relation type is specified.
| [http://tools.ietf.org/html/draft-yevstifeyev-disclosure-relation The 'disclosure' Link Relation Type]
|
| proposed


|-
|-
| [[rel-pgpkey|pgpkey]] || (see also rel-publickey) || &hellip; || [http://golem.ph.utexas.edu/~distler/blog/archives/000320.html], [http://golem.ph.utexas.edu/~distler/blog/archives/000325.html]
| [[rel-discussion|discussion]]
| Hyperlink
| Hyperlink
| Refers to discussion of the current document or post.
| [[rel-discussion]]
|
| proposed


|-
|-
| [[rel-pingback|pingback]] || Gives the address of the pingback server that handles pingbacks to the current document. (Allowed in <code>link</code> only) || &hellip; || WCLR/ HTML5
| [[rel-donation|donation]]
| Hyperlink
| Hyperlink
| Indicates that the destination of the hyperlink provides a way to show or give support (e.g. financial) for the current page on a voluntary basis
| No formal specification
| Closely related to [[rel-payment]]
| proposed


|-
|-
| [[rel-prefetch|prefetch]] || Specifies that the target resource should be pre-emptively cached. (Allowed in <code>link</code> only) || &hellip; || HTML5
| [[rel-dns-prefetch|dns-prefetch]]
| External Resource
| Not allowed
| Tells the browser to perform dns lookup for host names ahead of use.
| [https://developer.mozilla.org/En/Controlling_DNS_prefetching Mozilla documentation] [http://dev.chromium.org/developers/design-documents/dns-prefetching Google documentation]
|
| proposed


|-
|-
| [[rel-publickey|publickey]] || (see also rel-pgpkey) || &hellip; || [http://rasterweb.net/raster/2002/12/12/20021212072812/]
| [[rel-edit|edit]]
| Hyperlink
| Not allowed
| Tells the browser where the current page can be edited
| [http://universaleditbutton.org/Registered_MIME_type#Alternate_Linking_Scheme Universal Edit Button Alternate Linking Scheme].  Implemented in at least [http://mediawiki.org MediaWiki].
|
| proposed


|-
|-
| [[rel-referral|referral]] || &hellip; || &hellip; || WCLR
| [[rel-edituri|EditURI]]
| External Resource
| Not allowed
| A blogging auto discovery value, commonly used by WordPress
| [http://bitworking.org/projects/atom/draft-gregorio-09.html#Edit AtomAPI]
|
| proposed


|-
|-
| [[rel-related|related]] || &hellip; || &hellip; || WCLR
| [[rel-enclosure|enclosure]]
| External Resource
| External Resource
| Indicates that the referred resource is intended to be downloaded and cached.
| [[rel-enclosure]]
|
| proposed


|-
|-
| [[rel-replies|replies]] || indicates a continued thread || unknown || [http://www.apps.ietf.org/rfc/rfc4685.html RFC4685]
| [[rel-entry-content|entry-content]]
| Not allowed
| External Resource
| Indicates that the referenced document is an alternative display source for an Internet Explorer Web Slice.
| [http://msdn.microsoft.com/en-us/library/cc304073(VS.85).aspx#_alternative Web Slice format specification 0.9]
|
| proposed


|-
|-
| [[rel-resource|resource]] || &hellip; || &hellip; || WCLR
| [[rel-external|external]]
| Not allowed
| Hyperlink
| Indicates that the referenced document is not part of the same site as the current document.
| [[rel-external]]
|
| proposed


|-
|-
| [[rel-search|search]] || &hellip; || unknown || unknown
| [[rel-first|first]]
| Hyperlink
| Hyperlink
| Indicates that the document is part of a sequence, and that the link is leading to the document that is the first logical document in the sequence.
| [https://www.w3.org/TR/2011/WD-html5-20110113/links.html#link-type-first W3C Working Draft 13 January 2011]
|
| proposed


|-
|-
| [[rel-sitemap|sitemap]] || Provides a link to an XML document describing the layout of the site. || http://www.sitemaps.org/ || unknown
| [[rel-gbfs|gbfs]]
| External Resource
| Not allowed
| The location of the gbfs auto-discovery file
| [https://github.com/NABSA/gbfs/blob/master/gbfs.md General Bikeshare Feed Specification]
|
| proposed


|-
|-
| [[rel-sponsor|sponsor]] || &hellip; || &hellip; || WCLR
| [[rel-gtfs-static|gtfs-static]]
| External Resource
| Not allowed
| Indicates the associated GTFS Static file
| [https://developers.google.com/transit/gtfs/reference General Transit Feed Specification Reference]
|
| proposed


|-
|-
| [[rel-trackback|trackback]] || &hellip; || unknown, perhaps open source Movable Type blogging software || WCLR
| [[rel-gtfs-realtime|gtfs-realtime]]
| External Resource
| Not allowed
| Indicates the associated GTFS-Realtime file
| [https://developers.google.com/transit/gtfs-realtime/reference GTFS-realtime Reference]
|
| proposed


|-
|-
| [[rel-unendorsed|unendorsed]] || (probably redundant to [[rel-nofollow|nofollow]]) || &hellip; || WCLR
| [[rel-home|home]]
| Hyperlink
| Hyperlink
| Refers to the top level document for the current document. It can be combined with 'alternate' to indicate a feed for the site of the current page.
| [[rel-home]]
| [[rel-root]]
| proposed


|-
|-
| [[rel-user|user]] || &hellip; || &hellip; || WCLR
| [[rel-hub|hub]]
| Hyperlink
| Hyperlink
| Refers to a hub that enables registration for notification of updates to the current page.
| [http://pubsubhubbub.googlecode.com/svn/trunk/pubsubhubbub-core-0.3.html#discovery PubSubHubbub Spec] [https://www.w3.org/TR/websub/ WebSub spec]
|
| proposed


|-
|-
| [[rel-via|via]] || &hellip; || &hellip; || WCLR
| [[rel-import|import]]
| External Resource
| Not allowed
| HTML Imports are a way to include and reuse HTML documents in other HTML documents.
| [http://www.w3.org/TR/html-imports HTML Imports]
|
| proposed


|-
|-
| [[rel-wlwmanifest|wlwmanifest]] || Used by "[http://explore.live.com/windows-live-writer Windows Live Writer]," a Microsoft [http://codex.wordpress.org/Weblog_Client blog client] for automating posting and updating blog content from your desktop. || Seen in [http://www.wordpress.org/ WordPress], e.g. [http://www.tom-watson.co.uk/]. Probably used by other blog content management systems as well. || &hellip;
| [[rel-in-reply-to|in-reply-to]]
| Hyperlink
| Hyperlink
| Refers to an original post that the current page is a comment on or reply to.
| [[rel-in-reply-to]]
|
| proposed


|}
|-
| [[rel-root|root]]
| Hyperlink
| Hyperlink
| The target document is the root node of the hierarchical tree structure that hosts the current document
| No formal specification
| [[rel-home]]
| proposed


=== WCLR ===
|-
| [[rel-index|index]]
| Hyperlink
| Hyperlink
| Refers to a document providing a list of topics with pointers that pertain to the current document.
| [http://www.w3.org/TR/html4/types.html#h-6.12 HTML4]
|
| proposed


The WCLR proposal is described by its author (in e-mail, 2007-09-25) as:
|-
| [[rel-issues|issues]]
| Hyperlink
| Hyperlink
| Refers to issues regarding the current document or specification.
| [[rel-discussion]]
|
| proposed


<blockquote>
|-
<p>&hellip;now effectively obsolete, since HTML5 and Microformats cover all the worthwhile relationships in that already.</p>
| [[rel-jslicense|jslicense]]
| Hyperlink
| Hyperlink
| Refers to a document with JavaScript source code and license information (also called a [http://www.gnu.org/licenses/javascript-labels.html JavaScript License Web Labels] page). We might want choose a keyword for this that is more general -- there are many situations besides JavaScript in which it is desirable or required by license agreements (e.g., GNU GPL) to make an offer of both the source code and a copy of a license when distributing object code versions of a given work.
| [[rel-jslicense]]
|
| proposed


These are [http://www.whatwg.org/specs/web-apps/current-work/multipage/section-links.html#linkTypes covered by HTML5 already]:
|-
 
| [[rel-last|last]]
* permalink -> bookmark
| Hyperlink
* archive -> archives
| Hyperlink
* feed
| Indicates that the document is part of a sequence, and that the link is leading to the document that is the last logical document in the sequence.
* pingback
| [https://www.w3.org/TR/2011/WD-html5-20110113/links.html#link-type-last W3C Working Draft 13 January 2011]
* unendorsed -> nofollow
|
 
| proposed
The rest now seem unnecessary.
</blockquote>
 
Nonetheless, there may be some mileage in using them in microformats, at least until HTML5 is widely available.
 
== HTML5 link type extensions ==
 
The following values are registered as link type extensions per the [http://www.whatwg.org/specs/web-apps/current-work/multipage/links.html#other-link-types requirements in the WHATWG HTML spec] and the [http://dev.w3.org/html5/spec/links.html#other-link-types requirements in the W3C HTML5 spec].  
 
 
Before you register a new value:
* '''Please check the [[#formats|Formats table]] and DO NOT re-register''' rel values that are already there. Please note that the W3C HTML WG has made a [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Decision] to drop <code>index</code>, <code>up</code>, <code>first</code> and <code>last</code> from the HTML5 spec itself.
* '''Please check the [[#dropped|Dropped table]] and DO NOT register''' values that are already there. If you believe a rel value was dropped from another specification without prejudice, please provide link/cite to explicit text/decision stating as such, e.g. the value was merely postponed, or perhaps expected to be spun-out into its own spec from the group developing that specification.
 
Note that entries in the [[#formats|Formats table]] and entries that are already in HTML5 as built-in keywords are also considered extensions with the "Ratified" status.
 
Please make sure that registrations added here have all the required data filled in ''including'':
* "Effect on link"
* "Effect on a and area" and
* a link to a spec that documents the keyword ''as an HTML <code>rel</code> keyword''. (A spec that merely defines the file format of the link target but does not define the <code>rel</code> keyword for use in HTML is not the kind of spec that is being required here.)
 
Entries lacking any of the above required data will likely be removed.
 
Changes to this registry may not be reflected in validators in real time.
 
{| border="1"
|+
! Keyword
! Effect on <code>link</code>
! Effect on <code>a</code>, <code>area</code>
! Brief description
! Link to specification
! Synonyms
! Status


|-
|-
| [[rel-apple-touch-icon|apple-touch-icon]]
| [[rel-lightbox|lightbox]]
| External Resource
| Not allowed
| Not allowed
| Specify a Webpage Icon for a “Web Clip”, or “touch icon”, for mobile devices (not limited to Apple devices).
| Img Pop-Up
| [http://developer.apple.com/library/safari/#documentation/appleapplications/reference/safariwebcontent/configuringwebapplications/configuringwebapplications.html Apple's Safari Web Content Guide]
| Images with this attribute are displayed in a larger way than embedded in a website (or how you specified it) when clicked (e.g. with installed "Lightbox 2"-Plugin). When adding [group] to rel="lightbox" all images get a clickable button for next/prev; insert into <code>&lt;a rel="lightbox[group]">&lt;img src="http:example.com/img.jpg">&lt;/a></code>
| probably redundant with rel=icon
| [http://lokeshdhakar.com/projects/lightbox2/ Lightbox 2] (needs actual specification to be kept in this list, this link is just documentation of one implementation)
|
| proposed
| proposed


|-
|-
| [[rel-apple-touch-icon-precomposed|apple-touch-icon-precomposed]]
| [[rel-lightvideo|lightvideo]]
| External Resource
| Not allowed
| Not allowed
| Specify a Webpage Icon for a “Web Clip”, or “touch icon”, for mobile devices (not limited to Apple devices).
| Video Pop-Up
| [http://developer.apple.com/library/safari/#documentation/appleapplications/reference/safariwebcontent/configuringwebapplications/configuringwebapplications.html Apple's Safari Web Content Guide]
| Loads the video in a lightbox effect
| probably redundant with rel=icon
| [https://www.drupal.org/node/252276 Lightbox2 - How to display video content]
|
| proposed
| proposed


|-
|-
| [[rel-apple-touch-startup-image|apple-touch-startup-image]]  
| [[rel-main|main]]
| External Resource
| Hyperlink
| Not allowed
| Hyperlink
| Specify a splashscreen for Web apps on iOS Safari
| The current page is a subsection or a less important page than the target resource
| [http://developer.apple.com/library/safari/#documentation/appleapplications/reference/safariwebcontent/configuringwebapplications/configuringwebapplications.html Apple's Safari Web Content Guide]
| No formal specification
| maybe redundant with rel=icon with the sizes attribute?
| It can be a synonym of [[rel-parent]] when the latter refers to a document and not a person. It differs however from [[rel-home]] and [[rel-root]], as the latter refer only to the topmost resource in the hierarchical tree structure (and in this case they may be combined with [[rel-main|main]]). Note that [[rel-main]] does not necessarily refer to a higher node in a tree structure, as the target resource can simply be a more important sibling node.
| proposed
| proposed


|-
|-
| [[rel-canonical|canonical]]
| [[rel-manifest|manifest]]
| External Resource
| External Resource
| Not allowed
| Not allowed
| Specifies the canonical URL for the current document in order to help avoid duplicate content.
| Imports or links to a manifest
| [http://en.wikipedia.org/wiki/Canonical_meta_tag Canonical meta tag] [http://www.Google.com/support/webmasters/bin/answer.py?answer=139066#2 Canonicalization at Google Webmaster Central] [http://www.Bing.com/community/site_blogs/b/webmaster/archive/2009/02/12/partnering-to-help-solve-duplicate-content-issues.aspx Microsoft Webmaster Center] [http://www.YSearchBlog.com/2009/02/12/fighting-duplication-adding-more-arrows-to-your-quiver/ Yahoo! Search Blog]
| [http://w3c.github.io/manifest/#linking W3C Manifest for web application]
|
|
| proposed
| proposed


|-
|-
| [[rel-dns-prefetch|dns-prefetch]]
| [[rel-mask-icon|mask-icon]]
| External Resource
| External Resource
| Not allowed
| Not allowed
| Tells the browser to perform dns lookup for host names ahead of use.
| Specify a Webpage Icon for a “Pinned Tabs” on Safari 9.
| [https://developer.mozilla.org/En/Controlling_DNS_prefetching Mozilla documentation] [http://dev.chromium.org/developers/design-documents/dns-prefetching Google documentation]
| probably redundant with rel-icon
|
|
| proposed
| proposed


|-
|-
| [[rel-edituri|EditURI]]
| [[rel-meta|meta]]
| External Resource
| External Resource
| Not allowed
| Not allowed
| A blogging auto discovery value, commonly used by WordPress
| External metadata about the HTML document
| [http://bitworking.org/projects/atom/draft-gregorio-09.html#Edit AtomAPI]
| [http://www.w3.org/TR/2004/REC-rdf-syntax-grammar-20040210/#section-rdf-in-HTML W3C's RDF/XML Syntax Specification]
|
|
| proposed
| proposed


|-
|-
| [[rel-external|external]]
| [[rel-micropub|micropub]]
| External Resource
| Not allowed
| Not allowed
| Hyperlink
| the micropub endpoint for creating new posts
| Indicates that the referenced document is not part of the same site as the current document.
| [https://www.w3.org/TR/micropub/  Micropub scecification]
| [[rel-external]]
|
|
| proposed
| proposed


|-
|-
| [[rel-home|home]]
| [[rel-noopener|noopener]]
| Hyperlink
| Not allowed
| Hyperlink
| Annotation
| &hellip;indicates that the <nowiki>[referenced document]</nowiki> is the homepage of the site in which the current page appears. can be combined with 'alternate' to indicate for example a feed for the site of the current page.
| Requires that any browsing context created by following the hyperlink must not have an opener browsing context.
| [[rel-home]]
| [https://html.spec.whatwg.org/multipage/semantics.html#link-type-noopener 4.6.6.11 Link type ”noopener"]
|
| proposed
 
|-
| [[rel-index|index]]
| Hyperlink
| Hyperlink
| Refers to a document providing an index for the current document.
| [http://www.w3.org/TR/html4/types.html#h-6.12 HTML4]
|
|
| proposed
| proposed
Line 717: Line 1,077:
| [http://www.hixie.ch/specs/pingback/pingback Pingback]
| [http://www.hixie.ch/specs/pingback/pingback Pingback]
|
|
| proposed
|-
| [[rel-preconnect|preconnect]]
| External Resource
| Not allowed
| Indicates an origin that will be used to fetch required resources. Initiating an early connection, which includes the DNS lookup, TCP handshake, and optional TLS negotiation, allows the user agent to mask the high costs of connection establishment latency.
| [http://www.w3.org/TR/resource-hints/ Resource Hints Working Draft]
|
| proposed
| proposed


Line 722: Line 1,091:
| [[rel-prerender|prerender]]
| [[rel-prerender|prerender]]
| External Resource
| External Resource
| Not allowed
| External Resource
| Prerenders the Web page targeted by the link including running it scripts.
| Prerenders the Web page targeted by the link including running it scripts.
| [http://dev.chromium.org/developers/design-documents/prerender Chrome Prerendering]
| [[rel-prerender]]
|
|
| proposed
| proposed
 
|-
|-
| [[rel-profile|profile]]
| [[rel-profile|profile]]
Line 737: Line 1,106:
| proposed
| proposed


|-
| [[rel-publisher|publisher]]
| External Resource
| External Resource
| Indicates that the referenced document is a metadata profile (e.g., a social-media/real-name profile such as a Google+ profile) for the publisher of the current page, or some portion of the current page.
| [https://support.google.com/plus/answer/1713826?hl=en Google help page]
|
| proposed
|-
| [[rel-radioepg|radioepg]]
| External Resource
| External Resource
| Indicates that the referenced document is a RadioDNS Service Information document (ETSI TS 102 818 s10.2.3) containing information on the radio station that publishes the current page
| [https://radiodns.org/developers/documentation RadioDNS Documentation]
|
| proposed


|-
|-
| [[rel-service|service]]
| [[rel-rendition|rendition]]
| External Resource
| External Resource
| Indicates some example rendering, interpretation, or depiction of the source. User agents may choose to execute, display, or render the target in-place; or navigate to the target.
| [http://www.globalmentor.com/specs/html-rel-rendition/ HTML rel rendition]
|
| proposed
 
|-
| [[rel-reply-to|reply-to]]
| External Resource
| Hyperlink
| indicates any mailbox(es) (i.e. email addresses) to which responses are to be sent. ''Note: this is distinct from the 'in-reply-to' value which refers to the originating document, not to the address where comments should be sent.
| [http://tools.ietf.org/html/rfc2822 RFC2822] (originally [http://tools.ietf.org/html/rfc822#section-4.4.3 RFC822])
|
| ratified
 
|-
| [[rel-schema.DCTERMS|schema.DCTERMS]]
| External Resource
| External Resource
| Not allowed
| Not allowed
| Atom Publishing Protocol editing service autodiscovery.
| Maps the prefix "DCTERMS" for use in other Dublin-Core related link relations (such as DCTERMS.creator) and meta keywords
| [http://wiki.whatwg.org/wiki/ServiceRelExtension Documentation on the WHATWG wiki]
| [http://dublincore.org/documents/dc-html/#sect-4.2 Section 4.2 of "Expressing Dublin Core metadata using HTML/XHTML meta and link elements"]
|
| see also [https://wiki.whatwg.org/wiki/MetaExtensions "WhatWG MetaExtensions Wiki] for usage examples in meta keywords
| proposed
| proposed


|-
|-
| [[rel-shortcut|shortcut]]
| [[rel-service|service]]
| External Resource
| External Resource
| Not allowed
| Not allowed
| Used as a companion for <code>icon</code> for compatibility with IE.
| Atom Publishing Protocol editing service autodiscovery.
| [http://msdn.microsoft.com/en-us/library/ms537656%28v=vs.85%29.aspx#Associate_the_Icon_with_Your_Web_Page Documentation on MSDN]
| [http://wiki.whatwg.org/wiki/ServiceRelExtension Documentation on the WHATWG wiki]
|
|
| proposed
| proposed
Line 771: Line 1,175:
| Indicates that the referenced document is intended to be shown in a secondary browsing context.
| Indicates that the referenced document is intended to be shown in a secondary browsing context.
| [[rel-sidebar]]
| [[rel-sidebar]]
|
| proposed
|-
| [[rel-sitemap|sitemap]]
| External Resource
| Not allowed
| Provides a link to an XML document describing the layout of the site.
| [[rel-sitemap]]
|
| proposed
|-
| [[rel-subresource|subresource]]
| External Resource
| Not allowed
| An external resource intended for use within the current page.
| [http://www.chromium.org/spdy/link-headers-and-server-hint/link-rel-subresource Chromium documentation]
|
| proposed
|-
| [[rel-sword|sword]]
| Hyperlink
| Not allowed
| SWORD is a lightweight protocol for remotely depositing content into repositories. .[http://swordapp.org/ The SWORD project]
| [[rel-sword]]
|
| proposed
|-
| [[rel-syndication|syndication]]
| Hyperlink
| Hyperlink
| Refers to a page which is a syndicated copy of the current page.
| [[rel-syndication]]
|
|
| proposed
| proposed
Line 780: Line 1,221:
| Applies a timesheet to the document.
| Applies a timesheet to the document.
| [http://www.w3.org/TR/timesheets/#smilTimesheetsNS-Elements-Timesheet non-normative section in the Timesheet spec]
| [http://www.w3.org/TR/timesheets/#smilTimesheetsNS-Elements-Timesheet non-normative section in the Timesheet spec]
|
| proposed
|-
| [[rel-token_endpoint|token_endpoint]]
| External Resource
| Not allowed
| Specify an HTTP endpoint that Micropub clients can use to obtain an access token given an authorization code
| [https://www.w3.org/TR/indieauth/ IndieAuth spec]
|
| proposed
|-
| [[rel-webmention|webmention]]
| External Resource
| Hyperlink
| gives the address of the webmention endpoint that handles webmentions to the current document
| [https://www.w3.org/TR/webmention/ Webmention specification]
|
|
| proposed
| proposed
Line 828: Line 1,287:
| proposed
| proposed


|-
| [[rel-yandex-tableau-widget|yandex-tableau-widget]]
| External Resource
| Not allowed
| Lets webmasters configure the appearance of their own site widgets in Yandex.Browser
| [https://api.yandex.com/tableau/ Yandex's Tableau API]
|
| proposed
|}
== 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, <strong>consider trying out</strong> these values and provide feedback on the respective brainstorming page(s) with your results and experiences.
You may list new proposed rel values here, and even better if you can list and link to POSH uses in the wild.
{| border="1"
|+
! rel value !! summary !! brainstormed in and usage in the wild
|-
| [[rel-accessibility|accessibility]] || indicate[s] that the destination of that hyperlink contains accessibility information for the current page. || [http://www.brucelawson.co.uk/2009/rel-accessibility/ blog post] which itself uses the rel value in a &lt;link&gt; tag in the head of the document.
|-
| [[rel-author|author]] || indicate[s] that the destination of that hyperlink represents the author of the current page. Combines with [[rel-me|rel-me]] to chain authorship information. || Google has said it will index rel-Author in this [http://googlewebmastercentral.blogspot.com/2011/06/authorship-markup-and-web-search.html blog post], with further [http://www.google.com/support/webmasters/bin/answer.py?answer=1229920 discussion of the rel-me connection] See also [http://dev.w3.org/html5/spec/Overview.html#link-type-author the HTML5 spec]
|-
| [[rel-bibliography|bibliography]] || indicate[s] that the destination of that hyperlink is a bibliography for the current page. || [http://microformats.org/discuss/mail/microformats-discuss/2007-October/010863.html mailing list post, 2007-10-15]
|-
| [[rel-cite|cite]] || indicate[s] that the destination of that hyperlink is an authoritative source or a precedent to the current page. || [[distributed-conversation-brainstorming]]
|-
| [[rel-group|group]] || the referenced document represents a group to which the person represented by the current document belongs || [[group-brainstorming]]
|-
| <span id="longdesc">[[rel-longdesc|longdesc]]</span> || Alternative to the img longdesc attribute, for use on visible links || [http://www.google.com/search?q=rel%3D%22longdesc%22 Google search for rel=longdesc in the wild] shows many sources of proposals. Please edit this to list the earliest and perhaps most recent/comprehensive proposal. No known real world POSH usage in the wild yet.
|-
| [[rel-map|map]] || Link to a map. Possibly embedded within an adr, hCard, geo or hCalendar. Parsers {{may}} attempt to parse the URL if it is a link to a known map site (e.g. Geohash, Google Maps, Multimap) and extract co-ordinates and other useful data. || (to [[User:TobyInk|TobyInk]] by email)
|-
| [[rel-member|member]] || the referenced document represents a member of the group represented by the current document || [[group-brainstorming]]
|-
| [[rel-m_PageScroll2id|m_PageScroll2id]] || JS to scroll to a defined ID || [[group-brainstorming]]
|-
| [[rel-prefetch|prefetch]] || indicates the URL and content-type of a resource that is likely to be a required resource when the next action or navigation is triggered. Initiating an early fetch allows the user agent to mask the request latency of the resource and make it available sooner to the application.|| [https://igrigorik.github.io/resource-hints/#prefetch resource hints draft]
|-
| [[rel-preload|preload]] || indicates the URL and content-type of a resource that should be fetched as early as possible by the user agent. Initiating an early fetch allows the user agent to mask the request latency of the resource and make it available sooner to the application.|| [https://igrigorik.github.io/resource-hints/#preload resource hints draft]
|-
| [[rel-prerender|prerender]] || indicates the URL of the next navigation target. Initiating a prerender allows the user agent to deliver an instant navigation experience: the user agent downloads the top-level resource and its assets, and performs all of the processing steps required to show the page without actually showing it to the user.|| [https://igrigorik.github.io/resource-hints/#prerender resource hints draft]
|-
| [[rel-profile|profile]] || indicate[s] that the destination of that hyperlink is a metadata profile (e.g. an [[XMDP]] profile) for the current page or portion thereof || [[xmdp-brainstorming]]


|-
| [[rel-shortlink|shortlink]] || the referenced document represents the current document but with a shorter URL || [http://samj.net/2009/04/introducing-relshort-better-alternative.html blog post]
|-
| source || the referenced document represents the source code for the current document or project || [[source-brainstorming]] [http://adactio.com/journal/6667/ blog post]
|-
| vcalendar-parent || link from an event to a containing event || [[User:TobyInk/hcalendar-1.1|hCalendar 1.1 draft]]
|-
| vcalendar-child || link from an event to a contained event || [[User:TobyInk/hcalendar-1.1|hCalendar 1.1 draft]]
|-
| vcalendar-sibling || link from an event to a related event with the same container || [[User:TobyInk/hcalendar-1.1|hCalendar 1.1 draft]]
|-
| [[rel-status|status]] || the referenced document represents the status (or source of status updates) for the author of this document || [http://monkinetic.com/2009/11/24/status-autodiscovery-relstatus.html blog post]
|-
| https://api.w.org/ || Link to Wordpress API || [https://wordpress.org/themes/twentysixteen/ Official Wordpress theme]


|}
|}
=== more brainstorming ===
See also:
* [[genealogy-brainstorming]] for some thoughts on possible additional values for family relationships (use existing [[XFN]] [[rel-parent|parent]], [[rel-child|child]], [[rel-sibling|sibling]], [[rel-spouse|spouse]], [[rel-kin|kin]] values first though)
* [[xpn-brainstorming]] for some thoughts on possible additional values for professional relationships (use existing [[XFN]] [[rel-co-worker|co-worker]], [[rel-colleague|colleague]] values first though)
== 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: If a value is missing from this table, it may have either already been promoted by writing it up as a proposal, or demoted by being explicitly dropped. Please check the other tables first before adding to this table.
Note: this list is incomplete, please help complete it from the following sources:
External sources:
* [http://developer.mozilla.org/about/meta Meta Information in DevMo Docs] (DevMo)
* [http://wiki.mozilla.org/Microsummaries Microsummary]
* [http://lachy.id.au/dev/markup/specs/wclr/ Web Communication Link Relationships] (WCLR)
* [http://www.w3.org/MarkUp/Relationships.html W3C Link Relationship values draft] (LRdraft) - from a draft of the HTML spec circa 1991.
* [http://www.whatwg.org/specs/web-apps/current-work/multipage/section-links.html#linkTypes HTML5 draft] '''Liable to change'''
* [http://wiki.foaf-project.org/Autodiscovery FOAF Project Wiki: Autodiscovery] (FOAF)
* [http://www.apps.ietf.org/rfc/rfc4685.html RFC4685]
* [http://googlewebmastercentral.blogspot.com/2009/02/specify-your-canonical.html Google Blog]
{| border="1"
|+
! rel value !! summary !! origin !! proposal(s)
|-
| [[rel-archive|archive]] || index of archived entries || unknown, perhaps Wordpress open source blogging software || WCLR
|-
| [[rel-archives|archives]] || Provides a link to a collection of records, documents, or other materials of historical interest. ||  || HTML5
|-
|[[rel-author|author]]||see brainstorming above for suggested use by google||unknown || DevMo / HTML5
|-
| [[rel-canonical|canonical]] || To help search engines disambiguate the same page with multiple representations || Google || [http://googlewebmastercentral.blogspot.com/2009/02/specify-your-canonical.html Google]/[http://www.bing.com/community/blogs/webmaster/archive/2009/02/12/partnering-to-help-solve-duplicate-content-issues.aspx Microsoft]/[http://www.ysearchblog.com/2009/02/12/fighting-duplication-adding-more-arrows-to-your-quiver/ Yahoo!], [http://blog.ask.com/2009/02/ask-is-going-canonical.html Ask Jeeves]
|-
| [[rel-comment|comment]] || &hellip; || &hellip; || WCLR
|-
| [[rel-contribution|contribution]] || &hellip; || &hellip; || WCLR
|-
| [[rel-edituri|EditURI]]
| Location of the xml-rpc gateway for a Wordpress install that allows external programs to add, edit and delete posts. Used by "[http://codex.wordpress.org/Weblog_Client WordPress blog client]" software for automating posting and updating blog content from your desktop. || Seen in [http://www.wordpress.org/ WordPress], e.g. [http://www.tom-watson.co.uk/].  || Description stubbed in [[rel-edituri]].
|-
| [[rel-endorsed|endorsed]] || &hellip; || &hellip; || WCLR
|-
| [[rel-fan|fan]] || xxxx. || &hellip; || [[hcard-user-profile-authoring]]
|-
| [[rel-feed|feed]] || Gives the address of a syndication feed for the current document. || &hellip; || WCLR/ HTML5
|-
| [[rel-footnote|footnote]] || Location of the footnote on a link to a footnote. || Markdown preprocessors such as [http://maruku.rubyforge.org/ Maruku] || HTML5
|-
| [[rel-icon|icon]] || Imports an icon to represent the current document. (Allowed in <code>link</code> only) || [http://dev.w3.org/html5/spec-LC/links.html#rel-icon HTML5] || WCLR/HTML5
|-
| [[rel-kinetic-stylesheet|kinetic-stylesheet]] || Imports a [http://kssproject.org/ KSS] 'kinetic stylesheet' to bind dynamic behavior to elements || Used in the [http://plone.org Plone] Content Management System || &hellip;
|-
| [[rel-lightbox|lightbox]] || Hook - Indicates that following the link will trigger a "lightbox" script (Allowed in <code>link</code> only) || ([http://www.google.co.uk/search?q=rel%3D%22lightbox%22 Google search for rel=lightbox in the wild]) Use "lightbox" instead of "clearbox" or "prettyPhoto" || &hellip;
|-
| [[rel-made|made]] || &hellip; || &hellip; || LRdraft
|-
| [[rel-meta|meta]] || &hellip; ||  [http://www.w3.org/TR/1999/REC-rdf-syntax-19990222/#transport 1999 W3C RDF syntax REC] || FOAF
|-
| [[rel-microsummary|microsummary]]|| &hellip; || &hellip; ||[http://wiki.mozilla.org/Microsummaries Microsummary], be aware of: [[page-summary-formats#Issues_2|microsummary issues]]
|-
| [[rel-noreferrer|noreferrer]] || indicates that no referrer information is to be leaked when following the link. || [http://dev.w3.org/html5/spec-LC/links.html#rel-noreferrer HTML5] || HTML5
|-
| [[rel-openid-delegate|openid.delegate]] || &hellip; || ([http://www.google.co.uk/search?q=%22rel%3Dopenid%22 Google search for rel=openid.* in the wild]) || &hellip;
|-
| [[rel-openid-server|openid.server]] || &hellip; || ([http://www.google.co.uk/search?q=%22rel%3Dopenid%22 Google search for rel=openid.* in the wild]) || &hellip;
|-
| [[rel-permalink|permalink]] || indicate a permanent link for some, or all, content within the document. obsolete; use <code>bookmark</code> instead. || &hellip; || WCLR
|-
| [[rel-pgpkey|pgpkey]] || (see also rel-publickey) || &hellip; || [http://golem.ph.utexas.edu/~distler/blog/archives/000320.html], [http://golem.ph.utexas.edu/~distler/blog/archives/000325.html]
|-
| [[rel-pingback|pingback]] || Gives the address of the pingback server that handles pingbacks to the current document. (Allowed in <code>link</code> only) || &hellip; || WCLR/ HTML5
|-
| [[rel-popover|popover]] || Used by a JS widget to display a large, descriptive tooltip. || [http://twitter.github.com/bootstrap Twitter's Bootstrap] [http://twitter.github.com/bootstrap/javascript.html#popovers Popover.js] || &hellip;
|-
| [[rel-prefetch|prefetch]] || Specifies that the target resource should be pre-emptively cached. (Allowed in <code>link</code> only) || &hellip; || HTML5
|-
| [[rel-privacy|privacy]] || Specifies that the target resource is the privacy policy. || &hellip; || &hellip;
|-
| [[rel-publickey|publickey]] || (see also rel-pgpkey) || &hellip; || [http://rasterweb.net/raster/2002/12/12/20021212072812/]
|-
| [[rel-referral|referral]] || &hellip; || &hellip; || WCLR
|-
| [[rel-related|related]] || &hellip; || &hellip; || WCLR
|-
| [[rel-replies|replies]] || indicates a continued thread || unknown || [http://www.apps.ietf.org/rfc/rfc4685.html RFC4685]
|-
| [[rel-respond-proxy|respond-proxy]] || Working with respond.js - proxy on external server || [https://github.com/scottjehl/Respond] || [https://github.com/scottjehl/Respond]
|-
| [[rel-respond-redirect|respond-redirect]] || Working with respond.js - redirect location on local server || [https://github.com/scottjehl/Respond] || [https://github.com/scottjehl/Respond]
|-
| [[rel-resource|resource]] || &hellip; || &hellip; || WCLR
|-
| [[rel-search|search]] || &hellip; || unknown || unknown
|-
| [[rel-sitemap|sitemap]] || Links to a site map document. || &hellip; || http://www.sitemaps.org/
|-
| [[rel-sponsor|sponsor]] || &hellip; || &hellip; || WCLR
|-
| [[rel-tooltip|tooltip]] || Used by a JS widget to display a tooltip similar (though more customizable) to what is shown by browsers if the 'title' attribute is present. || [http://twitter.github.com/bootstrap Twitter's Bootstrap] [http://twitter.github.com/bootstrap/javascript.html#tooltips Tooltip.js] (and likely other JS tools) || &hellip;
|-
| [[rel-trackback|trackback]] || &hellip; || unknown, perhaps open source Movable Type blogging software || WCLR
|-
| [[rel-unendorsed|unendorsed]] || (probably redundant to [[rel-nofollow|nofollow]]) || &hellip; || WCLR
|-
| [[rel-user|user]] || &hellip; || &hellip; || WCLR
|-
| [[rel-wlwmanifest|wlwmanifest]] || Used by "[http://explore.live.com/windows-live-writer Windows Live Writer]," a Microsoft [http://codex.wordpress.org/Weblog_Client blog client] for automating posting and updating blog content from your desktop. || Seen in [http://www.wordpress.org/ WordPress], e.g. [http://www.tom-watson.co.uk/]. Similar values are probably used by other blog content management systems as well. || &hellip;
|}
=== WCLR ===
The WCLR proposal is described by its author (in e-mail, 2007-09-25) as:
<blockquote>
<p>&hellip;now effectively obsolete, since HTML5 and Microformats cover all the worthwhile relationships in that already.</p>
These are [http://www.whatwg.org/specs/web-apps/current-work/multipage/section-links.html#linkTypes covered by HTML5 already]:
* permalink -> bookmark
* archive -> archives
* feed
* pingback
* unendorsed -> nofollow
The rest now seem unnecessary.
</blockquote>
Nonetheless, there may be some mileage in using them in microformats, at least until HTML5 is widely available.
== Dublin Core ==
In the past, Dublin Core values have been added to this page in the table about HTML5 features, but no examples, nor an actual specification explicitly stating how the value(s) should be used in HTML could be found. The linked specifications below have been updated so we should start considering Dublin Core values accordingly.
{| border="1"
|+
! rel value !! summary !! source
|-
| schema.DC || a specification of all metadata terms maintained by the Dublin Core Metadata Initiative, with regard to the fifteen terms of the Dublin Core Metadata Element Set already published || [http://www.dublincore.org/documents/dcq-html/ Dublin Core]
|-
| schema.DCTERMS || a specification of all metadata terms maintained by the Dublin Core Metadata Initiative, reflecting the changes described more fully in the 2012 document "Maintenance changes to DCMI Metadata Terms" [http://dublincore.org/usage/decisions/2012/dcterms-changes/] || [http://www.dublincore.org/documents/dcq-html/ Dublin Core]
|-
|}
'''Issues need updating given new information from linked resources.'''
Notes:
* Dublin Core. This search may help: [http://www.google.co.uk/search?as_q=rel%3Dschema.*&hl=en&num=10&btnG=Google+Search&as_epq=&as_oq=&as_eq=&lr=&as_ft=i&as_filetype=&as_qdr=all&as_occt=any&as_dt=i&as_sitesearch=http%3A%2F%2Fdublincore.org&as_rights=&safe=images].
** '''examples from that search only use invisible <code>&lt;link href&gt;</code> element'''. At first glance it appears the results from the search show only uses with the invisible <code>&lt;link href&gt;</code> element which is not ideal for content relationships.  Content relationships should be user visible and thus uses with <code>&lt;a href&gt;</code> are strongly preferred. 
*** [http://www.ietf.org/rfc/rfc2731.txt RFC2731] defines <code>rel="schema.AC"</code> and <code>rel="schema.RC"</code> with the pattern <code>rel="schema.PREFIX"</code> as a syntax for defining namespaces for use in meta[@name], *[@rel], *[@rev] and (as per eRDF) *[@class] attributes. A link to a Dublin Core metadata schema is generally not suitable for end users, so <code>&lt;link href&gt;</code> appears to be more appropriate than <code>&lt;a href&gt;</code> for those that use Dublin Core metadata schemas.
*** The scheme proposed above provides metadata namespace declarations. As described by DCMI specifications, such indications '''cannot''' be provided w/o a suitable namespace. In order to give complete pieces of information, the correct description set must be: <code>&lt;link rel="schema.DCTERMS" href="http://purl.org/dc/terms/"&gt;</code> (for the namespace declaration, followed by) <code>&lt;meta name="DCTERMS.<nowiki>[element]</nowiki>" content="<nowiki>[element.value]</nowiki>"&gt;</code> for related elements.
**** Note: [http://purl.org/dc/terms/ schema.DCTERMS] is conventionally related to an upgraded elements list than [http://purl.org/dc/elements/1.1/ schema.DC] and should be preferred as rel values. Both are discussed here for subject completeness)
** '''proposal to use in content currently only theoretical'''. Thus unfortunately the use of Dublin Core in user visible content like <code>&lt;a href&gt;</code> appears to be strictly theoretical. See [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011445.html microformats-discuss/2008-January/011445.html] for a proposal to use Dublin Core in user visible content.
*** '''recent improvements'''. DCMI solves some trouble concerning metadata through the ''description set model''. Some of these informations cannot currently be provided in any standard ways other than DC, namely dates, validity and periodicity. Following this public bug report ([https://www.w3.org/Bugs/Public/show_bug.cgi?format=multiple&id=22520]), the correct namespace declaration for DC and DCTERMS metadata are now considered valid HTML code. We '''must''' encourage this practice both for internal usefulness and for shared practices.
* The Dublin Core document [http://dublincore.org/documents/dc-html/ "Expressing Dublin Core metadata using HTML/XHTML meta and link elements"] is a specification for, and gives examples of, both <link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"> and <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/">. Note that Dublin Core encourages the use of DCTERMS elements over DC. A list of projects which use Dublin Core metadata is maintained [http://dublincore.org/projects/ here].
* [http://dublincore.org/documents/dc-html/ "Expressing Dublin Core metadata using HTML/XHTML meta and link elements"] also includes examples of <link rel="DCTERMS.[element]" href="">, where [element] = subject, isReferencedBy, creator, and publisher. The <link> tag is used instead of the <meta> tag whenever the content is a URL. (Note that this use is different from, but related to, <link rel="schema.DCTERMS" href="">.) Potentially, ''any'' of the 55 DCTERMS elements could be used in this way, and this could include use in HTML 5.
** As said before, HTML5 validators now allow the use of <code>&lt;link rel="schema.DCTERMS" href="http://purl.org/dc/terms/"&gt;</code> for namespace declarations.
* According to DCMI specification linked above, as well as [http://dublincore.org/documents/dc-html/ "Expressing Dublin Core metadata using HTML/XHTML meta and link elements"] documentation, HTML5 @rel attribute proposed values table has been updated. It now includes a subset of DCMI ''/terms/'' namespace properties, more specifically those whose value can (or must) be logically expressed by a resource, so that the "href" attribute value becomes a non-literal value surrogate referring to the resource itself.
** Elements from ''/elements/1.1/'' namespace have not been included on purpose. According to [http://wiki.dublincore.org/index.php/FAQ/DC_and_DCTERMS_Namespaces "FAQ/DC and DCTERMS Namespaces"], the old namespace is maintained for legacy purposes only and it is not as suitable for non-literal values as the ones denoted by <code>&lt;link></code> elements.
== Use with HTTP Link Header ==
You can also use any of the rel values (that are allowed for link elements) with HTTP Link Headers,
Example: returning a Javascript file with a license (since JS itself has no way to indicate a license)
<syntaxhighlight lang=text>
Link: <http://creativecommons.org/publicdomain/zero/1.0/>; rel="license"
</syntaxhighlight>
For multiple licenses (e.g. CC-SA and GPL), simply use multiple <code>Link:</code> headers.
<syntaxhighlight lang=text>
Link: <http://creativecommons.org/licenses/by-sa/3.0/>; rel="license"
Link: <http://www.gnu.org/licenses/gpl.html>; rel="license"
</syntaxhighlight>
Example: similarly, linking to a copyright statement for an image:
<syntaxhighlight lang=text>
Link: <http://example.org/copyright.html>; rel="copyright"
</syntaxhighlight>
or providing a brief inline copyright statement:
<syntaxhighlight lang=text>
Link: <data:text/plain;charset=utf-8,Copyright 2013 ExampleCo, All Rights Reserved.>; rel="copyright"
</syntaxhighlight>
== 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 HTML '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 such precise URLs to examples/specs are provided, the values can be treated as they are purely theoretical and thus of little interest.
A simple list here is sufficient.


== non HTML rel values ==
== non HTML rel values ==
Line 842: Line 1,613:
* See [http://amundsen.com/media-types/collection/format/#link-relations Collection+JSON]
* See [http://amundsen.com/media-types/collection/format/#link-relations Collection+JSON]
* See [http://www.opensearch.org/Specifications/OpenSearch/1.1#Url_rel_values OpenSearch]
* See [http://www.opensearch.org/Specifications/OpenSearch/1.1#Url_rel_values OpenSearch]
* See [http://tools.ietf.org/html/rfc6861 The Create-Form and Edit-Form Link Relations (RFC6861)]
* See [http://rels.messages.io Workflow-Related Link Relations at Messages.io]


{| border="1"
{| border="1"
Line 853: Line 1,626:


|-
|-
| in-reply-to || See http://code.google.com/apis/youtube/2.0/developers_guide_protocol_comments.html || YouTube + Atom
| http://gdata.youtube.com/schemas/2007#in-reply-to || See http://code.google.com/apis/youtube/2.0/developers_guide_protocol_comments.html || YouTube extension to Atom


|-
|-
Line 861: Line 1,634:
   || Maze+XML, Collection+JSON, OpenSearch
   || Maze+XML, Collection+JSON, OpenSearch


|-
| compensatingtx || Link to a resource representing information about a compensating transaction for each member transaction of a [http://www.cs.cornell.edu/andru/cs711/2002fa/reading/sagas.pdf Long-Lived Compensating Transaction] || See [http://rels.messages.io/#compensatingtx Compensating Transaction Link Relation]


|-
|-
Line 868: Line 1,643:


  || Maze+XML
  || Maze+XML
|-
| events || Link to a collection resource representing a list of subscribe-able events. || See [http://rels.messages.io/#events Events Link Relation]


|-
|-
Line 890: Line 1,668:


  || Maze+XML
  || Maze+XML
|-
| [[rel-via|via]] || Identifies a resource that is the source of the information in the context. ||  Atom 1.0 Syndication format (RFC 4287)


|-
|-
Line 900: Line 1,683:
|-
|-
| item || The target IRI points to a resource that is a member of a collection represented by the context IRI. || Collection+JSON
| item || The target IRI points to a resource that is a member of a collection represented by the context IRI. || Collection+JSON
|-
| create-form || When included in a resource, the "create-form" link relation MAY identify a target resource that represents the form to append a new member to the link context. || See [http://tools.ietf.org/html/rfc6861 The Create-Form and Edit-Form Link Relations (RFC6861)]
|-
| edit-form || When included in a resource, the "edit-form" link relation identifies a target resource that represents the form for editing associated resource. || See [http://tools.ietf.org/html/rfc6861 The Create-Form and Edit-Form Link Relations (RFC6861)]
|-
| lightframe || Opens the target in a lightbox. On inclusion it provides a simple target the lightframe and loads the content in a lightbox effect || Lightbox
|-
| superbox[image] || jQuery Superbox! is a script which allows you display windows with the lightbox effect. || superbox
|-
| wp-video-lightbox || wp-video-lightbox! is a rel to anchor tag script display videos with the lightbox effect. || wp-video-lightbox
|-
| youtube || Opens the target youtube video in using the Swipebox Plugin || Swipebox
|-
| shadowbox || shadowbox is a jQuery script for images displaying with the "lightbox" effects. || shadowbox
|-
| permission || When included in a resource, the "permission" link relation MAY identify a target resource that represents the list of entities that can access or modify the resource in the link context. || See [http://cdoc.io/spec.html#permission-link-relation Collection Document Media Type Specification]
|-
| sub || When included in a resource representation of an event, the "sub" (subscription) link relation MAY identify a target resource that represents the ability to subscribe to the pub/sub  event-type resource in the link context. || See [http://rels.messages.io/#sub Subscription Link Relation]
|-
| unsub || When included in a resource representation of an event, the "unsub" (subscription cancellation) link relation MAY identify a target resource that represents the ability to un-subscribe from the pub/sub  event-type resource in the link context. || See [http://rels.messages.io/#unsub Subscription Cancellation Link Relation]
|-
| version-history
| When included on a versioned resource, this link points to a resource containing the version history for this resource.
| [http://tools.ietf.org/html/rfc5829 RFC 5829]
|-
| latest-version
| When included on a versioned resource, this link points to a resource containing the latest (e.g., current) version.
| [http://tools.ietf.org/html/rfc5829 RFC 5829]
|-
| working-copy
| When included on a versioned resource, this link points to a working copy for this resource.
| [http://tools.ietf.org/html/rfc5829 RFC 5829]
|-
| working-copy-of
| When included on a working copy, this link points to the versioned resource from which this working copy was obtained.
| [http://tools.ietf.org/html/rfc5829 RFC 5829]
|-
| predecessor-version
| When included on a versioned resource, this link points to a resource containing the predecessor version in the version history.
| [http://tools.ietf.org/html/rfc5829 RFC 5829]
|-
| successor-version
| When included on a versioned resource, this link points to a resource containing the successor version in the version history.
| [http://tools.ietf.org/html/rfc5829 RFC 5829]


|-
|-
Line 1,027: Line 1,870:
|-
|-
| [[rel-first|first]]
| [[rel-first|first]]
| synonym for <code>begin</code>
| Synonym for <code>start</code>
| HTML4dropped - never in an official spec
| HTML4dropped - never in an official spec
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]
Line 1,034: Line 1,877:
| [[rel-index|index]]
| [[rel-index|index]]
| Refers to a document providing an index for the current document.
| Refers to a document providing an index for the current document.
| was in [http://www.w3.org/TR/html4/types.html#h-6.12 HTML4]
| was in [http://www.w3.org/TR/html4/types.html#h-6.12 HTML4];  the token has been re-registered within the [[#HTML5_link_type_extensions|HTML5 link type extensions]] and is now valid.
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]


|-
|-
| [[rel-last|last]]
| [[rel-last|last]]
| synonym for <code>end</code>
| Refers to the last document in a collection of documents.
| HTML4dropped - never in an official spec
| HTML4dropped - never in an official spec
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]
Line 1,045: Line 1,888:
|-
|-
| [[rel-up|up]]
| [[rel-up|up]]
|When the document forms part of a hierarchy, this link references the immediate parent of the current document.
| When the document forms part of a hierarchy, this link references the immediate parent of the current document. Synonym for <code>parent</code>.
| was in [http://www.w3.org/MarkUp/html3/dochead.html HTML3] - but [http://www.w3.org/TR/html401/types.html#type-links dropped in HTML4]
| was in [http://www.w3.org/MarkUp/html3/dochead.html HTML3] - but [http://www.w3.org/TR/html401/types.html#type-links dropped in HTML4]
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]
| [http://lists.w3.org/Archives/Public/public-html/2011Feb/att-0481/issue-118-decision.html Explicitly dropped from HTML5 interim draft yet permitted for external registry]
Line 1,062: Line 1,905:
|+  
|+  
! rel value !! origin / proposal !! why rejected  
! rel value !! origin / proposal !! why rejected  
|-
| [[rel-logo|logo]]
| [http://relogo.org Relogo.org]
| [[rejected-formats#Logo]]
|-
|-
|[[rel-pavatar|pavatar]] || [http://pavatar.com/ pavatar] || [[rejected-formats#Pavatar]]
|[[rel-pavatar|pavatar]] || [http://pavatar.com/ 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 such precise URLs to examples/specs are provided, the values can be treated as they are purely theoretical and thus of little interest.
{| border="1"
|+
! rel value !!"summary !! source
|-
| schema.DC || &hellip; || [http://www.dublincore.org/documents/dcq-html/ Dublin Core]
|-
| schema.DCTERMS || &hellip; || [http://www.dublincore.org/documents/dcq-html/ Dublin Core]
|-
|}
Notes:
* Dublin Core. This search may help: [http://www.google.co.uk/search?as_q=rel%3Dschema.*&hl=en&num=10&btnG=Google+Search&as_epq=&as_oq=&as_eq=&lr=&as_ft=i&as_filetype=&as_qdr=all&as_occt=any&as_dt=i&as_sitesearch=http%3A%2F%2Fdublincore.org&as_rights=&safe=images].
** '''examples from that search only use invisible <code>&lt;link href&gt;</code> element'''. At first glance it appears the results from the search show only uses with the invisible <code>&lt;link href&gt;</code> element which is not ideal for content relationships.  Content relationships should be user visible and thus uses with <code>&lt;a href&gt;</code> are strongly preferred. 
*** [http://www.ietf.org/rfc/rfc2731.txt RFC2731] defines <code>rel="schema.AC"</code> and <code>rel="schema.RC"</code> with the pattern <code>rel="schema.PREFIX"</code> as a syntax for defining namespaces for use in meta[@name], *[@rel], *[@rev] and (as per eRDF) *[@class] attributes. A link to a Dublin Core metadata schema is generally not suitable for end users, so <code>&lt;link href&gt;</code> appears to be more appropriate than <code>&lt;a href&gt;</code> for those that use Dublin Core metadata schemas.
** '''proposal to use in content currently only theoretical'''. Thus unfortunately the use of Dublin Core in user visible content like <code>&lt;a href&gt;</code> appears to be strictly theoretical. See [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011445.html microformats-discuss/2008-January/011445.html] for a proposal to use Dublin Core in user visible content.


== tools ==
== tools ==

Revision as of 23:54, 30 November 2022


This page contains tables of known HTML 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.

usage: see how is 'rel' used. Regarding rev, see: should 'rev' even be used.

This page is also the official rel registry (WHATWG HTML (original link), W3C HTML5). Add new and proposed rel values to the following section:


formats

These rel values are defined formats from specifications (HTML 4, microformats) are thus are recommended for general use. Alphabetically ordered by value.

Note:

  • Do not add proposed rel values for HTML5 here, add them to the HTML5 link type extensions table.
  • Do not add rel values you find in the wild to this table of rel formats, instead add them to the table in the POSH section.
  • Do not add non-HTML rel values you find to this table of rel formats, instead add them to the table in the non HTML rel values section.
  • Do not add rel values from obsolete/superceded proposals or drafts, instead add them to the table in the "dropped" section.

Sources:

Keyword Effect on link Effect on a, area Brief description
(from the relevant specification where possible)
Link to defining specification
acquaintance not allowed external relation the person represented by the current document considers the person represented by the referenced document to be an acquaintance XFN
alternate external resource external relation 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 types
appendix allowed allowed Refers to a document serving as an appendix in a collection of documents. HTML4 Link types


bookmark not allowed allowed 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 types
chapter allowed allowed Refers to a document serving as a chapter in a collection of documents. HTML4 Link types
child external relation external relation The referenced person is a child of the person represented by the current document. It may also indicate that the target document is a hierarchical child, or subdocument, of the current document. XFN, HTML 4.0 Specification
colleague not allowed external relation the referenced person is a colleague of the person represented by the current document XFN
contact not allowed external relation the person represented by the current document considers the person represented by the referenced document to be a contact XFN
contents allowed allowed Refers to a document serving as a table of contents. Some user agents also support the synonym ToC (from "Table of Contents"). HTML4 Link types
copyright allowed allowed Refers to a copyright statement for the current document. HTML4 Link types
co-resident not allowed external relation the referenced person lives in the same residence as the person represented by the current document XFN
co-worker not allowed external relation the referenced person is a co-worker of the person represented by the current document XFN
crush not allowed external relation this person considers the referenced person to be a crush (i.e. has a crush on the referenced person) XFN
date not allowed external relation this person considers the referenced person to be a date (i.e. is dating the referenced person) XFN
friend not allowed external relation the person represented by the current document considers the person represented by the referenced document to be a friend XFN
glossary allowed allowed Refers to a document providing a list of terms and their definitions that pertain to the current document. HTML4 Link types
help allowed allowed Refers to a document offering help (more information, links to other sources information, etc.) HTML4 Link types
its-rules allowed not allowed Refers to a document with external ITS rules. Internationalization Tag Set (ITS) Version 2.0
kin not allowed external relation the referenced person is part of the extended family of the person represented by the current document XFN
license allowed allowed …indicates that the [referenced document] is a license for the current page. rel-license
me external relation external relation the referenced document represents the same person as does the current document XFN
met not allowed external relation this person has met the referenced person XFN
muse not allowed external relation the referenced person inspires the person represented by the current document XFN
neighbor not allowed external relation the referenced person lives nearby the person represented by the current document XFN
next external relation external relation 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 types
nofollow not allowed external relation 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 external relation external relation The referenced person is a parent of the person represented by the current document. It may also indicate that the target document is the hierarchical parent, or container, of the current document. XFN, HTML 4.0 Specification
prev external relation external relation Refers to the previous document in an ordered series of documents. Some user agents also support the synonym "Previous". HTML4 Link types
previous external relation external relation Synonym of prev HTML4 Link types
section allowed allowed Refers to a document serving as a section in a collection of documents. HTML4 Link types
sibling not allowed external relation the referenced person is a sibling of the person represented by the current document XFN
spouse not allowed external relation the referenced person is a spouse of the person represented by the current document XFN
start allowed allowed 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 types
stylesheet external resource not allowed a style sheet for the current document
used with the invisible <link href> element which is not ideal for content relationships. Content relationships should be user visible and thus uses with <a href> are strongly preferred. Unfortunately the use of stylesheet in user visible content like <a href> appears to be strictly theoretical.
HTML4 Link types
subsection allowed allowed Refers to a document serving as a subsection in a collection of documents. HTML4 Link types
sweetheart not allowed external relation this person considers the referenced person to be their sweetheart XFN
tag not allowed allowed …indicates that the [referenced document] is an author-designated "tag" (or keyword/subject) for the current page. rel-tag
toc allowed allowed Synonym of contents (from "Table Of Contents") HTML4 Link types
transformation allowed allowed Relates a source document to a transformation, usually represented in XSLT, that relates the source document syntax to the RDF graph syntax. Used in GRDDL GRDDL

notes

  • rel="alternate" can take further meaning from additional attributes, such as
    • rel="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 external spec (if any)
pronunciation …indicates that the destination of the 'link' element is a document providing a pronunciation lexicon for speech-synthesis purposes. rel-pronunciation
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 RFC4287
home …indicates that the [referenced document] is the homepage of the site in which the current page appears. rel-home
payment …indicates that the destination of the hyperlink provides a way to show or give support (e.g. financial) for the current page rel-payment
vcs-* …indicates that the destination of the hyperlink is the location of a Version Control System repository related to that page. rel=vcs-*

HTML5 link type extensions

The following values are registered as link type extensions per the requirements in the WHATWG HTML spec and the requirements in the W3C HTML5 spec.


Before you register a new value:

  • Please check the Formats table and DO NOT re-register rel values that are already there. Please note that the W3C HTML WG has made a Decision to drop index, up, first and last from the HTML5 spec itself.
  • Please check the Dropped table and DO NOT register values that are already there. If you believe a rel value was dropped from another specification without prejudice, please provide link/cite to explicit text/decision stating as such, e.g. the value was merely postponed, or perhaps expected to be spun-out into its own spec from the group developing that specification.

Note that entries in the Formats table and entries that are already in HTML5 as built-in keywords are also considered extensions with the "Ratified" status.

Please make sure that registrations added here have all the required data filled in including:

  • "Effect on link"
  • "Effect on a and area" and
  • a link to a spec that documents the keyword as an HTML rel keyword. (A spec that merely defines the file format of the link target but does not define the rel keyword for use in HTML is not the kind of spec that is being required here.)

Entries lacking any of the above required data will likely be removed.

Changes to this registry will not be reflected in validators in real time. But validators will typically get automatically updated with the changes within one week or so

Keyword Effect on link Effect on a, area Brief description Link to specification Synonyms Status


about Hyperlink Hyperlink The resource linked to contains information about the current page. RFC6903 It might combine with rel-me or rel-author in links to an "about" section focused on an author proposed
amphtml Hyperlink Hyperlink Specify an alternate version of the document written in AMP HTML AMP HTML documentation could be combined with rel=alternate proposed
apple-touch-icon External Resource Not allowed Specify a Webpage Icon for a “Web Clip”, or “touch icon”, for mobile devices (not limited to Apple devices). Apple's Safari Web Content Guide probably redundant with rel=icon proposed
apple-touch-icon-precomposed External Resource Not allowed Specify a Webpage Icon for a “Web Clip”, or “touch icon”, for mobile devices (not limited to Apple devices). Apple's Safari Web Content Guide probably redundant with rel=icon proposed
apple-touch-startup-image External Resource Not allowed Specify a splashscreen for Web apps on iOS Safari Apple's Safari Web Content Guide maybe redundant with rel=icon with the sizes attribute? proposed
archived External Resource Hyperlink Annotation The target resource is archived and kept largely or solely for historical purposes. rel="archived" description proposed
attachment Hyperlink Hyperlink The resource linked to is "attached" to this document, similar to email attachments. Used in WordPress. No formal specification proposed
authorization_endpoint External Resource Not allowed Specify a hosted authorization server IndieAuth spec proposed
canonical Hyperlink Hyperlink Specifies the canonical URL for the current document in order to help avoid duplicate content. Canonical meta tag Canonicalization at Google Webmaster Central Microsoft Webmaster Center Yahoo! Search Blog proposed
category Hyperlink Hyperlink Refers to a category assigned to the current document or post. Implemented by WordPress for indicating a relation between a blog post and a category. rel-category proposed
code-repository Hyperlink Hyperlink indicates a code repository location. For link, it specifically indicates, in the case of server-generated content, the location of source code responsible for the generation of the current page, or, in the case of static files, where copies of the current page are housed). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the generator and content-repository should be used to indicate the location for the storage of content. Otherwise, the code repository can be considered as also including the content. While the repository should contain its own license file, the code-license rel-value is proposed as a direct pointer to the license (see also content-license). proposed
code-license Hyperlink Hyperlink indicates a license for code (a proposed broader replacement for jslicense). For link, it specifically indicates, in the case of server-generated content, the location of the license for all source code responsible for the generation of the current page, or, in the case of static files, the location of the license for all of these files). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the generator and content-license should be used to indication the license for the content. Otherwise, code-license can be considered as also covering the license of the content. Pointing to the repository containing the static or generator code files should be done with code-repository (and content-repository for any separate content). proposed


component External Resource Not allowed Specify an HTML document that is treated as a component of this document. Web Components proposed
chrome-webstore-item External Resource Not allowed Link tag to declare for app and extensions inline installations hosted in the Chrome Web Store. Using Inline Installation proposed
content-repository Hyperlink Hyperlink indicates a repository housing data content. For link, it specifically indicates, in the case of server-generated content, the location where separately housed data files used to populate the current page are stored (otherwise "code-repository" is sufficient to include content as well as code). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the data/content files and code-repository should be used to indicate the location for the storage of the generator source files. Otherwise, code-repository can be considered as also including the content instead. While the repository should contain its own license file, the content-license rel-value is proposed as a direct pointer to the license (see also code-license). proposed
content-license Hyperlink Hyperlink indicates a license for data content. For link, it specifically indicates, in the case of server-generated content, the location of the license for all separately housed data files used to populate the current page are stored, (otherwise "code-license" is sufficient to cover the license of content as well as code)). If the specific data/content built up at the page is stored separately from the generator (e.g., the code for a CMS vs. the specific CMS instance's SQL tables or JSON data files), this only refers to the data/content files and code-license should be used to indication the license for the generator source files. Otherwise, code-license can be considered as also covering the license of the content. Pointing to the repository containing the data files should be done with content-repository (and code-repository for the static or generator code files). proposed


DCTERMS.conformsTo External Resource Not allowed An established standard to which the described resource conforms.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.conformsTo" content="..." /> proposed
DCTERMS.contributor External Resource Not allowed An entity responsible for making contributions to the resource. Examples include a person, an organization, or a service.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.contributor" content="..." /> proposed
DCTERMS.creator External Resource Not allowed An entity primarily responsible for making the resource. Examples include a person, an organization, or a service.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.creator" content="..." /> proposed
DCTERMS.description External Resource Not allowed An account of the resource. Description may include but is not limited to: an abstract, a table of contents, a graphical representation, or a free-text account of the resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.description" content="..." /> proposed
DCTERMS.hasFormat External Resource Not allowed A related resource that is substantially the same as the pre-existing described resource, but in another format.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.hasPart External Resource Not allowed A related resource that is included either physically or logically in the described resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.hasVersion External Resource Not allowed A related resource that is a version, edition, or adaptation of the described resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.isFormatOf External Resource Not allowed A related resource that is substantially the same as the described resource, but in another format.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.isPartOf External Resource Not allowed A related resource in which the described resource is physically or logically included.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.isReferencedBy External Resource Not allowed A related resource that references, cites, or otherwise points to the described resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.isReplacedBy External Resource Not allowed A related resource that supplants, displaces, or supersedes the described resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.isRequiredBy External Resource Not allowed A related resource that requires the described resource to support its function, delivery, or coherence.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.isVersionOf External Resource Not allowed A related resource of which the described resource is a version, edition, or adaptation.
Changes in version imply substantive changes in content rather than differences in format.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.license External Resource Not allowed A legal document giving official permission to do something with the resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.license" content="..." /> proposed
DCTERMS.mediator External Resource Not allowed An entity that mediates access to the resource and for whom the resource is intended or useful. In an educational context, a mediator might be a parent, teacher, teaching assistant, or care-giver.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.mediator" content="..." /> proposed
DCTERMS.publisher External Resource Not allowed An entity responsible for making the resource available. Examples include a person, an organization, or a service.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.publisher" content="..." /> proposed
DCTERMS.references External Resource Not allowed A related resource that is referenced, cited, or otherwise pointed to by the described resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.relation External Resource Not allowed A related resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.replaces External Resource Not allowed A related resource that is supplanted, displaced, or superseded by the described resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.requires External Resource Not allowed A related resource that is required by the described resource to support its function, delivery, or coherence.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.rightsHolder External Resource Not allowed A person or organization owning or managing rights over the resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms It may be replaced by the literal value in form of <meta name="DCTERMS.rightsHolder" content="..." /> proposed
DCTERMS.source External Resource Not allowed A related resource from which the described resource is derived.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
DCTERMS.subject External Resource Not allowed The topic of the resource.

Requires Dublin Core namespace declaration: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/" />

DCMI Metadata Terms proposed
disclosure Not allowed External Resource The 'disclosure' Link Relation Type designates a list of patent disclosures or a particular patent disclosure itself made with respect to material for which such relation type is specified. The 'disclosure' Link Relation Type proposed
discussion Hyperlink Hyperlink Refers to discussion of the current document or post. rel-discussion proposed
donation Hyperlink Hyperlink Indicates that the destination of the hyperlink provides a way to show or give support (e.g. financial) for the current page on a voluntary basis No formal specification Closely related to rel-payment proposed
dns-prefetch External Resource Not allowed Tells the browser to perform dns lookup for host names ahead of use. Mozilla documentation Google documentation proposed
edit Hyperlink Not allowed Tells the browser where the current page can be edited Universal Edit Button Alternate Linking Scheme. Implemented in at least MediaWiki. proposed
EditURI External Resource Not allowed A blogging auto discovery value, commonly used by WordPress AtomAPI proposed
enclosure External Resource External Resource Indicates that the referred resource is intended to be downloaded and cached. rel-enclosure proposed
entry-content Not allowed External Resource Indicates that the referenced document is an alternative display source for an Internet Explorer Web Slice. Web Slice format specification 0.9 proposed
external Not allowed Hyperlink Indicates that the referenced document is not part of the same site as the current document. rel-external proposed
first Hyperlink Hyperlink Indicates that the document is part of a sequence, and that the link is leading to the document that is the first logical document in the sequence. W3C Working Draft 13 January 2011 proposed
gbfs External Resource Not allowed The location of the gbfs auto-discovery file General Bikeshare Feed Specification proposed
gtfs-static External Resource Not allowed Indicates the associated GTFS Static file General Transit Feed Specification Reference proposed
gtfs-realtime External Resource Not allowed Indicates the associated GTFS-Realtime file GTFS-realtime Reference proposed
home Hyperlink Hyperlink Refers to the top level document for the current document. It can be combined with 'alternate' to indicate a feed for the site of the current page. rel-home rel-root proposed
hub Hyperlink Hyperlink Refers to a hub that enables registration for notification of updates to the current page. PubSubHubbub Spec WebSub spec proposed
import External Resource Not allowed HTML Imports are a way to include and reuse HTML documents in other HTML documents. HTML Imports proposed
in-reply-to Hyperlink Hyperlink Refers to an original post that the current page is a comment on or reply to. rel-in-reply-to proposed
root Hyperlink Hyperlink The target document is the root node of the hierarchical tree structure that hosts the current document No formal specification rel-home proposed
index Hyperlink Hyperlink Refers to a document providing a list of topics with pointers that pertain to the current document. HTML4 proposed
issues Hyperlink Hyperlink Refers to issues regarding the current document or specification. rel-discussion proposed
jslicense Hyperlink Hyperlink Refers to a document with JavaScript source code and license information (also called a JavaScript License Web Labels page). We might want choose a keyword for this that is more general -- there are many situations besides JavaScript in which it is desirable or required by license agreements (e.g., GNU GPL) to make an offer of both the source code and a copy of a license when distributing object code versions of a given work. rel-jslicense proposed
last Hyperlink Hyperlink Indicates that the document is part of a sequence, and that the link is leading to the document that is the last logical document in the sequence. W3C Working Draft 13 January 2011 proposed
lightbox Not allowed Img Pop-Up Images with this attribute are displayed in a larger way than embedded in a website (or how you specified it) when clicked (e.g. with installed "Lightbox 2"-Plugin). When adding [group] to rel="lightbox" all images get a clickable button for next/prev; insert into <a rel="lightbox[group]"><img src="http:example.com/img.jpg"></a> Lightbox 2 (needs actual specification to be kept in this list, this link is just documentation of one implementation) proposed
lightvideo Not allowed Video Pop-Up Loads the video in a lightbox effect Lightbox2 - How to display video content proposed
main Hyperlink Hyperlink The current page is a subsection or a less important page than the target resource No formal specification It can be a synonym of rel-parent when the latter refers to a document and not a person. It differs however from rel-home and rel-root, as the latter refer only to the topmost resource in the hierarchical tree structure (and in this case they may be combined with main). Note that rel-main does not necessarily refer to a higher node in a tree structure, as the target resource can simply be a more important sibling node. proposed
manifest External Resource Not allowed Imports or links to a manifest W3C Manifest for web application proposed
mask-icon External Resource Not allowed Specify a Webpage Icon for a “Pinned Tabs” on Safari 9. probably redundant with rel-icon proposed
meta External Resource Not allowed External metadata about the HTML document W3C's RDF/XML Syntax Specification proposed


micropub External Resource Not allowed the micropub endpoint for creating new posts Micropub scecification proposed
noopener Not allowed Annotation Requires that any browsing context created by following the hyperlink must not have an opener browsing context. 4.6.6.11 Link type ”noopener" proposed
openid.delegate External Resource Not allowed When the page that contains the link is used as an OpenID indentifier, the relying party perform sOpenID 1.1 authentication with the link target as the identifier instead. OpenID Authentication 1.1 proposed
openid.server External Resource Not allowed The OpenID server for the relying party to contact for OpenID 1.1 authentication OpenID Authentication 1.1 proposed
openid2.local_id External Resource Not allowed When the page that contains the link is used as an OpenID indentifier, the relying party perform sOpenID 2.0 authentication with the link target as the identifier instead. OpenID Authentication 2.0 proposed
openid2.provider External Resource Not allowed The OpenID server for the relying party to contact for OpenID 2.0 authentication OpenID Authentication 2.0 proposed
p3pv1 External Resource Not allowed References a machine-readable privacy policy description in the P3P format P3P spec proposed
pgpkey External Resource Not allowed Associates a PGP key with a Web page so that the Web page URL can be used as the commenter's URL in PGP-signed blog comments and the blogging system receiving the comment can fetch the key and verify the signature as belonging to the owner of the URL. PGP-Signed Comments proposed
pingback External Resource Not allowed gives the address of the pingback server that handles pingbacks to the current document Pingback proposed
preconnect External Resource Not allowed Indicates an origin that will be used to fetch required resources. Initiating an early connection, which includes the DNS lookup, TCP handshake, and optional TLS negotiation, allows the user agent to mask the high costs of connection establishment latency. Resource Hints Working Draft proposed
prerender External Resource External Resource Prerenders the Web page targeted by the link including running it scripts. rel-prerender proposed
profile External Resource Contextual External Resource indicate[s] that the destination of that hyperlink is a metadata profile (e.g. an XMDP profile) for the current page or portion thereof. See also xmdp-brainstorming. rel-profile proposed
publisher External Resource External Resource Indicates that the referenced document is a metadata profile (e.g., a social-media/real-name profile such as a Google+ profile) for the publisher of the current page, or some portion of the current page. Google help page proposed
radioepg External Resource External Resource Indicates that the referenced document is a RadioDNS Service Information document (ETSI TS 102 818 s10.2.3) containing information on the radio station that publishes the current page RadioDNS Documentation proposed
rendition External Resource External Resource Indicates some example rendering, interpretation, or depiction of the source. User agents may choose to execute, display, or render the target in-place; or navigate to the target. HTML rel rendition proposed
reply-to External Resource Hyperlink indicates any mailbox(es) (i.e. email addresses) to which responses are to be sent. Note: this is distinct from the 'in-reply-to' value which refers to the originating document, not to the address where comments should be sent. RFC2822 (originally RFC822) ratified
schema.DCTERMS External Resource Not allowed Maps the prefix "DCTERMS" for use in other Dublin-Core related link relations (such as DCTERMS.creator) and meta keywords Section 4.2 of "Expressing Dublin Core metadata using HTML/XHTML meta and link elements" see also "WhatWG MetaExtensions Wiki for usage examples in meta keywords proposed
service External Resource Not allowed Atom Publishing Protocol editing service autodiscovery. Documentation on the WHATWG wiki proposed
shortlink External Resource Not allowed Specifies the preferred shortened URL for the page. shortlink spec proposed
sidebar Hyperlink Hyperlink Indicates that the referenced document is intended to be shown in a secondary browsing context. rel-sidebar proposed


sitemap External Resource Not allowed Provides a link to an XML document describing the layout of the site. rel-sitemap proposed
subresource External Resource Not allowed An external resource intended for use within the current page. Chromium documentation proposed
sword Hyperlink Not allowed SWORD is a lightweight protocol for remotely depositing content into repositories. .The SWORD project rel-sword proposed
syndication Hyperlink Hyperlink Refers to a page which is a syndicated copy of the current page. rel-syndication proposed
timesheet External Resource Not allowed Applies a timesheet to the document. non-normative section in the Timesheet spec proposed
token_endpoint External Resource Not allowed Specify an HTTP endpoint that Micropub clients can use to obtain an access token given an authorization code IndieAuth spec proposed
webmention External Resource Hyperlink gives the address of the webmention endpoint that handles webmentions to the current document Webmention specification proposed
widget External Resource External Resource Autodiscovery for W3C widgets non-normative section in the Widget packaging spec proposed
wlwmanifest External Resource Not allowed Windows Live Writer manifest autodiscovery documentation on MSDN proposed
image_src External Resource Not allowed Specify a Webpage Icon for use by Facebook, Yahoo, Digg, etc. Unknown, but see for instance this probably redundant with rel=icon proposed
http://docs.oasis-open.org/ns/cmis/link/200908/acl External Resource External Resource Identifies the resource containing a CMIS ACL document for the link context CMIS 1.0, Section 3.4.3.4 proposed
stylesheet/less External Resource Not allowed Less CSS framework stylesheets. Less CSS usage proposed
yandex-tableau-widget External Resource Not allowed Lets webmasters configure the appearance of their own site widgets in Yandex.Browser Yandex's Tableau API proposed


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.

You may list new proposed rel values here, and even better if you can list and link to POSH uses in the wild.

rel value summary brainstormed in and usage in the wild
accessibility indicate[s] that the destination of that hyperlink contains accessibility information for the current page. blog post which itself uses the rel value in a <link> tag in the head of the document.
author indicate[s] that the destination of that hyperlink represents the author of the current page. Combines with rel-me to chain authorship information. Google has said it will index rel-Author in this blog post, with further discussion of the rel-me connection See also the HTML5 spec


bibliography indicate[s] that the destination of that hyperlink is a bibliography for the current page. mailing list post, 2007-10-15
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


longdesc Alternative to the img longdesc attribute, for use on visible links Google search for rel=longdesc in the wild shows many sources of proposals. Please edit this to list the earliest and perhaps most recent/comprehensive proposal. No known real world POSH usage in the wild yet.
map Link to a map. Possibly embedded within an adr, hCard, geo or hCalendar. Parsers MAY attempt to parse the URL if it is a link to a known map site (e.g. Geohash, Google Maps, Multimap) and extract co-ordinates and other useful data. (to TobyInk by email)
member the referenced document represents a member of the group represented by the current document group-brainstorming
m_PageScroll2id JS to scroll to a defined ID group-brainstorming
prefetch indicates the URL and content-type of a resource that is likely to be a required resource when the next action or navigation is triggered. Initiating an early fetch allows the user agent to mask the request latency of the resource and make it available sooner to the application. resource hints draft
preload indicates the URL and content-type of a resource that should be fetched as early as possible by the user agent. Initiating an early fetch allows the user agent to mask the request latency of the resource and make it available sooner to the application. resource hints draft
prerender indicates the URL of the next navigation target. Initiating a prerender allows the user agent to deliver an instant navigation experience: the user agent downloads the top-level resource and its assets, and performs all of the processing steps required to show the page without actually showing it to the user. resource hints draft
profile indicate[s] that the destination of that hyperlink is a metadata profile (e.g. an XMDP profile) for the current page or portion thereof xmdp-brainstorming
shortlink the referenced document represents the current document but with a shorter URL blog post
source the referenced document represents the source code for the current document or project source-brainstorming blog post
vcalendar-parent link from an event to a containing event hCalendar 1.1 draft
vcalendar-child link from an event to a contained event hCalendar 1.1 draft
vcalendar-sibling link from an event to a related event with the same container hCalendar 1.1 draft
status the referenced document represents the status (or source of status updates) for the author of this document blog post
https://api.w.org/ Link to Wordpress API Official Wordpress theme

more brainstorming

See also:

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: If a value is missing from this table, it may have either already been promoted by writing it up as a proposal, or demoted by being explicitly dropped. Please check the other tables first before adding to this table.

Note: this list is incomplete, please help complete it from the following sources:

External sources:


rel value summary origin proposal(s)
archive index of archived entries unknown, perhaps Wordpress open source blogging software WCLR
archives Provides a link to a collection of records, documents, or other materials of historical interest. HTML5
author see brainstorming above for suggested use by google unknown DevMo / HTML5
canonical To help search engines disambiguate the same page with multiple representations Google Google/Microsoft/Yahoo!, Ask Jeeves
comment WCLR
contribution WCLR
EditURI Location of the xml-rpc gateway for a Wordpress install that allows external programs to add, edit and delete posts. Used by "WordPress blog client" software for automating posting and updating blog content from your desktop. Seen in WordPress, e.g. [1]. Description stubbed in rel-edituri.
endorsed WCLR
fan xxxx. hcard-user-profile-authoring
feed Gives the address of a syndication feed for the current document. WCLR/ HTML5
footnote Location of the footnote on a link to a footnote. Markdown preprocessors such as Maruku HTML5
icon Imports an icon to represent the current document. (Allowed in link only) HTML5 WCLR/HTML5
kinetic-stylesheet Imports a KSS 'kinetic stylesheet' to bind dynamic behavior to elements Used in the Plone Content Management System
lightbox Hook - Indicates that following the link will trigger a "lightbox" script (Allowed in link only) (Google search for rel=lightbox in the wild) Use "lightbox" instead of "clearbox" or "prettyPhoto"
made LRdraft
meta 1999 W3C RDF syntax REC FOAF
microsummary Microsummary, be aware of: microsummary issues
noreferrer indicates that no referrer information is to be leaked when following the link. HTML5 HTML5
openid.delegate (Google search for rel=openid.* in the wild)
openid.server (Google search for rel=openid.* in the wild)
permalink indicate a permanent link for some, or all, content within the document. obsolete; use bookmark instead. WCLR
pgpkey (see also rel-publickey) [2], [3]
pingback Gives the address of the pingback server that handles pingbacks to the current document. (Allowed in link only) WCLR/ HTML5
popover Used by a JS widget to display a large, descriptive tooltip. Twitter's Bootstrap Popover.js
prefetch Specifies that the target resource should be pre-emptively cached. (Allowed in link only) HTML5
privacy Specifies that the target resource is the privacy policy.
publickey (see also rel-pgpkey) [4]
referral WCLR
related WCLR
replies indicates a continued thread unknown RFC4685


respond-proxy Working with respond.js - proxy on external server [5] [6]
respond-redirect Working with respond.js - redirect location on local server [7] [8]
resource WCLR
search unknown unknown
sitemap Links to a site map document. http://www.sitemaps.org/
sponsor WCLR
tooltip Used by a JS widget to display a tooltip similar (though more customizable) to what is shown by browsers if the 'title' attribute is present. Twitter's Bootstrap Tooltip.js (and likely other JS tools)
trackback unknown, perhaps open source Movable Type blogging software WCLR
unendorsed (probably redundant to nofollow) WCLR
user WCLR
wlwmanifest Used by "Windows Live Writer," a Microsoft blog client for automating posting and updating blog content from your desktop. Seen in WordPress, e.g. [9]. Similar values are probably used by other blog content management systems as well.


WCLR

The WCLR proposal is described by its author (in e-mail, 2007-09-25) as:

…now effectively obsolete, since HTML5 and Microformats cover all the worthwhile relationships in that already.

These are covered by HTML5 already:

  • permalink -> bookmark
  • archive -> archives
  • feed
  • pingback
  • unendorsed -> nofollow

The rest now seem unnecessary.

Nonetheless, there may be some mileage in using them in microformats, at least until HTML5 is widely available.

Dublin Core

In the past, Dublin Core values have been added to this page in the table about HTML5 features, but no examples, nor an actual specification explicitly stating how the value(s) should be used in HTML could be found. The linked specifications below have been updated so we should start considering Dublin Core values accordingly.

rel value summary source
schema.DC a specification of all metadata terms maintained by the Dublin Core Metadata Initiative, with regard to the fifteen terms of the Dublin Core Metadata Element Set already published Dublin Core
schema.DCTERMS a specification of all metadata terms maintained by the Dublin Core Metadata Initiative, reflecting the changes described more fully in the 2012 document "Maintenance changes to DCMI Metadata Terms" [10] Dublin Core

Issues need updating given new information from linked resources.

Notes:

  • Dublin Core. This search may help: [11].
    • examples from that search only use invisible <link href> element. At first glance it appears the results from the search show only uses with the invisible <link href> element which is not ideal for content relationships. Content relationships should be user visible and thus uses with <a href> are strongly preferred.
      • RFC2731 defines rel="schema.AC" and rel="schema.RC" with the pattern rel="schema.PREFIX" as a syntax for defining namespaces for use in meta[@name], *[@rel], *[@rev] and (as per eRDF) *[@class] attributes. A link to a Dublin Core metadata schema is generally not suitable for end users, so <link href> appears to be more appropriate than <a href> for those that use Dublin Core metadata schemas.
      • The scheme proposed above provides metadata namespace declarations. As described by DCMI specifications, such indications cannot be provided w/o a suitable namespace. In order to give complete pieces of information, the correct description set must be: <link rel="schema.DCTERMS" href="http://purl.org/dc/terms/"> (for the namespace declaration, followed by) <meta name="DCTERMS.[element]" content="[element.value]"> for related elements.
        • Note: schema.DCTERMS is conventionally related to an upgraded elements list than schema.DC and should be preferred as rel values. Both are discussed here for subject completeness)
    • proposal to use in content currently only theoretical. Thus unfortunately the use of Dublin Core in user visible content like <a href> appears to be strictly theoretical. See microformats-discuss/2008-January/011445.html for a proposal to use Dublin Core in user visible content.
      • recent improvements. DCMI solves some trouble concerning metadata through the description set model. Some of these informations cannot currently be provided in any standard ways other than DC, namely dates, validity and periodicity. Following this public bug report ([12]), the correct namespace declaration for DC and DCTERMS metadata are now considered valid HTML code. We must encourage this practice both for internal usefulness and for shared practices.
  • According to DCMI specification linked above, as well as "Expressing Dublin Core metadata using HTML/XHTML meta and link elements" documentation, HTML5 @rel attribute proposed values table has been updated. It now includes a subset of DCMI /terms/ namespace properties, more specifically those whose value can (or must) be logically expressed by a resource, so that the "href" attribute value becomes a non-literal value surrogate referring to the resource itself.
    • Elements from /elements/1.1/ namespace have not been included on purpose. According to "FAQ/DC and DCTERMS Namespaces", the old namespace is maintained for legacy purposes only and it is not as suitable for non-literal values as the ones denoted by <link> elements.

Use with HTTP Link Header

You can also use any of the rel values (that are allowed for link elements) with HTTP Link Headers,

Example: returning a Javascript file with a license (since JS itself has no way to indicate a license)

Link: <http://creativecommons.org/publicdomain/zero/1.0/>; rel="license"

For multiple licenses (e.g. CC-SA and GPL), simply use multiple Link: headers.

Link: <http://creativecommons.org/licenses/by-sa/3.0/>; rel="license"
Link: <http://www.gnu.org/licenses/gpl.html>; rel="license"

Example: similarly, linking to a copyright statement for an image:

Link: <http://example.org/copyright.html>; rel="copyright"

or providing a brief inline copyright statement:

Link: <data:text/plain;charset=utf-8,Copyright 2013 ExampleCo, All Rights Reserved.>; rel="copyright"

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 HTML '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 such precise URLs to examples/specs are provided, the values can be treated as they are purely theoretical and thus of little interest.

A simple list here is sufficient.

non HTML rel values

There are markup languages other than HTML that also have a rel attribute, often based upon the HTML rel attribute. It is useful to document some of these other languages and their rel values for both reference purposes, and to provide background research for the possible development and re-use of these values in HTML, as poshformats or microformats

Sources:

rel value summary
(from the relevant specification where possible))
defining specification
self From http://www.ietf.org/rfc/rfc4287.txt :

The value "self" signifies that the IRI in the value of the href attribute identifies a resource equivalent to the containing element.

Atom http://www.ietf.org/rfc/rfc4287.txt
http://gdata.youtube.com/schemas/2007#in-reply-to See http://code.google.com/apis/youtube/2.0/developers_guide_protocol_comments.html YouTube extension to Atom
collection Refers to a resource which represents a collection of which the current resource is a member.

When used in the Maze+XML media type, the associated URI returns the available collection of mazes.

Maze+XML, Collection+JSON, OpenSearch
compensatingtx Link to a resource representing information about a compensating transaction for each member transaction of a Long-Lived Compensating Transaction See Compensating Transaction Link Relation
east Refers to a resource to the "east" of the current resource.

When used in the Maze+XML media type, the associated URI points to a neighboring cell resource to the east in the active maze.

Maze+XML
events Link to a collection resource representing a list of subscribe-able events. See Events Link Relation
exit Refers to a resource that represents the exit or end of the current client actvity or process.

When used in the Maze+XML media type, the associated URI points to the final exit resource of the active maze.

Maze+XML


north Refers to a resource that is "north" of the current resource.

When used in the Maze+XML media type, the associated URI points to a neighboring cell resource to the north in the active maze.

Maze+XML
south Refers to a resource that is "south" of the current resource.

When used in the Maze+XML media type, the associated URI points to a neighboring cell resource to the south in the active maze.

Maze+XML


via Identifies a resource that is the source of the information in the context. Atom 1.0 Syndication format (RFC 4287)


west Refers to a resource that is "west" of the current resource.

When used in the Maze+XML media type, the associated URI points to a neighboring cell resource to the west in the active maze.

Maze+XML
item The target IRI points to a resource that is a member of a collection represented by the context IRI. Collection+JSON
create-form When included in a resource, the "create-form" link relation MAY identify a target resource that represents the form to append a new member to the link context. See The Create-Form and Edit-Form Link Relations (RFC6861)
edit-form When included in a resource, the "edit-form" link relation identifies a target resource that represents the form for editing associated resource. See The Create-Form and Edit-Form Link Relations (RFC6861)
lightframe Opens the target in a lightbox. On inclusion it provides a simple target the lightframe and loads the content in a lightbox effect Lightbox
superbox[image] jQuery Superbox! is a script which allows you display windows with the lightbox effect. superbox
wp-video-lightbox wp-video-lightbox! is a rel to anchor tag script display videos with the lightbox effect. wp-video-lightbox
youtube Opens the target youtube video in using the Swipebox Plugin Swipebox
shadowbox shadowbox is a jQuery script for images displaying with the "lightbox" effects. shadowbox
permission When included in a resource, the "permission" link relation MAY identify a target resource that represents the list of entities that can access or modify the resource in the link context. See Collection Document Media Type Specification
sub When included in a resource representation of an event, the "sub" (subscription) link relation MAY identify a target resource that represents the ability to subscribe to the pub/sub event-type resource in the link context. See Subscription Link Relation
unsub When included in a resource representation of an event, the "unsub" (subscription cancellation) link relation MAY identify a target resource that represents the ability to un-subscribe from the pub/sub event-type resource in the link context. See Subscription Cancellation Link Relation
version-history When included on a versioned resource, this link points to a resource containing the version history for this resource. RFC 5829
latest-version When included on a versioned resource, this link points to a resource containing the latest (e.g., current) version. RFC 5829
working-copy When included on a versioned resource, this link points to a working copy for this resource. RFC 5829
working-copy-of When included on a working copy, this link points to the versioned resource from which this working copy was obtained. RFC 5829
predecessor-version When included on a versioned resource, this link points to a resource containing the predecessor version in the version history. RFC 5829
successor-version When included on a versioned resource, this link points to a resource containing the successor version in the version history. RFC 5829
... ... ...

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.

In general, you SHOULD NOT use any dropped values.

If any such values have been superceded by standard values (see the first table on this page), then you MUST NOT use the dropped versions.

In particular:

  • if a rel value was in a draft and is missing (without explanation) from the final spec, or
  • if a rel value was in a previous version of and is missing (without explanation) from an update to the specification (even a draft update)

Then absent any other information or explanation, it is presumed that the group/editors working on that specification decided to explicitly drop it (either in development, or in the updated version) and thus it should be obsoleted (not re-registered).

If you wish to add them, please research why such values were omitted from latter specifications before doing so. If you do discover the reasoning, please add a short statement or link to thereof into the appropriate place in the following table.

If there is more data, e.g. a link to an email of discussion of the spec development that explains why the rel value was dropped, and it explicitly states, e.g. it was without prejudice, or merely post-poned, or perhaps expected to be spun-out into its spec (or some other explicit positive reason), then it makes to link/cite that explicit text as part of a proposal.

Sources:

  • HTML3 (HTML3) / 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.)
  • Proposed HTML 4.0 link types (HTML4dropped) - obsoleted/superceded by the HTML 4.0 Recommendation. Any values that were in the "Proposed HTML 4.0 link types" document but didn't make it into the HTML 4.0 Recommendation were thus explicitly dropped and should be avoided.
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). HTML3 unknown
begin identifies the author-defined start of a sequence of documents of which the current document is a node. HTML4dropped unknown
biblioentry identifies a bibliographic entry HTML4dropped unknown
bibliography identifies a bibliography HTML4dropped unknown
child (obsolete/superceded) the target document is a hierarchical child, or subdocument, of the current document HTML4dropped unknown
citation the target is a bibliographic citation HTML4dropped unknown
collection the target document is an collection that contains the current document HTML4dropped unknown
definition identifies a definition of a term HTML4dropped unknown
disclaimer identifies a hypertext link to a legal disclaimer HTML4dropped unknown
editor identifies a hypertext link to an editor HTML4dropped unknown
end identifies the author-defined end of a sequence of documents of which the current document is a node. HTML4dropped unknown
footnote the anchor is a footnote marker and the target is a footnote HTML4dropped unknown
navigate the target document contains information such as a image map that will help users to gain a sense of how and where to found information HTML4dropped unknown
origin synonym for top HTML4dropped unknown
parent (obsolete/superceded) the target document is the hierarchical parent, or container, of the current document HTML4dropped unknown
pointer the target is a pointer to the real target. This value can be used by a user agent to perform a pre-fetch of the specified target for evaluation until the real target is reached HTML4dropped unknown
publisher identifies a hypertext link to a publisher HTML4dropped unknown
sibling (obsolete/superceded) the target document is a child of a common parent, or a hierarchical peer of the current document HTML4dropped unknown
top the target document is the logical top node of the tree (see also begin) HTML4dropped unknown
trademark identifies a hypertext link to a trademark notice HTML4dropped unknown
translation the target is a translation to another language HTML4dropped unknown


urc identifies a Universal Resource Citation HTML4dropped unknown

dropped without prejudice

In one known instance (from HTML4 to HTML5), some rel values were in an earlier version of a specification (or a proposal) and were dropped from a latter (draft) version, and it was noted that these values were dropped with the intent that they could still be proposed in a registry and thus they explicitly were not deprecated or obsoleted. This section documents such values as separate from the dropped section.

In general, you SHOULD NOT use any dropped values.

If any such values have been superceded by standard values (see the first table on this page), then you MUST NOT use the dropped versions.

Rel values that were dropped without prejudice from a specification will be considered similar to new values that have never been specified.

If you know of additional rel values that were dropped without prejudice from an update to a specification, please cite a URL and quote from the group developing the specification that officially states from that group that the dropping of the values was done without prejudice, or equivalent statement (such as explicit allowance of external registration, proposal, and/or development).

This table serves a historical purpose. If you wish to propose a value from this table, please copy it and leave it in place.

Sources:

  • Several rel values were explicitly dropped from HTML5. Per: Issue 118 Decision (emphasis added):

    "The final proposal argues for the removal of some relation values, to wit, it suggests removal of index, up, first and last. It was pointed out in survey comments that these relations are already registered in the IANA link relation registry. Presumably, these relations could also be entered in whatever other registry or registries HTML5 adopts for this purpose.

    ...

    "Next Steps

    ...

    "Since the relations to be removed are already registered at the IANA link relation registry, no further action is needed to include them there. WG members are free to register or record these relations elsehwere [sic], as well."

rel value summary defining specification why dropped
first Synonym for start HTML4dropped - never in an official spec Explicitly dropped from HTML5 interim draft yet permitted for external registry
index Refers to a document providing an index for the current document. was in HTML4; the token has been re-registered within the HTML5 link type extensions and is now valid. Explicitly dropped from HTML5 interim draft yet permitted for external registry
last Refers to the last document in a collection of documents. HTML4dropped - never in an official spec Explicitly dropped from HTML5 interim draft yet permitted for external registry
up When the document forms part of a hierarchy, this link references the immediate parent of the current document. Synonym for parent. was in HTML3 - but dropped in HTML4 Explicitly dropped from HTML5 interim draft yet permitted for external registry

See related HTML5: Link types for existing HTML5 specified rel values.

rejected

Some rel values have been proposed and rejected. They are listed here to make that explicit. Authors MUST NOT use rejected rel values.

Source: rejected-formats.

rel value origin / proposal why rejected
logo Relogo.org rejected-formats#Logo
pavatar pavatar rejected-formats#Pavatar

tools

See implementations.

addtional external research

Here are some additional historical references to the development or rel-values which may be useful when researching values, especially why specific values may have been proposed but abandoned.

previous attempts at documenting

There have been previous attempts at documenting known rel values, most of which fell out of date due to being dependent on a single author maintaining them. They're listed here purely for historical reasons, and are not sufficient to be references of their own (since they're just individual curations of other references)

related

copyright

norights-a.gif All text of this page is available under the terms of the Creative Commons Public Domain License. (See Copyrights for details.)