Proposed Relationship Values

Status The authorship of this document is unknown. It has no status.

This lists all the proposed relationship values known by W3C at the time of writing. Some values have been dropped because they have been consistently misunderstood or because other equivalent mechanisms have been developed in the interim.

Browser-defined Links

Some keywords are reserved and should not be used as REL/REV values.

HTML user agents typically provide a mechanism for navigating through the recent history of a user's access to documents; traditionally these operations are referred to as "back" and "forward". These mechanisms allow a user to step back through the documents which led to the current location and then forward again to retrace the path. Additionally, most user agents provide a mechanism to immediately return to a user-defined location, traditionally referred to as the home page, or "home". Since these browser actions are internally implemented by the browser, REL/REV keywords associated with these relationships are disallowed.

HOME
RESERVED. Defined by the user (using the WWW_HOME environment variable). This relationship may not be overridden; HTML user agents should ignore any author-supplied REL=HOME setting.
BACK
RESERVED. Defined by the browser. This relationship may not be overridden; HTML user agents should ignore any author-supplied REL=BACK setting.
FORWARD
RESERVED. Defined by the browser. This relationship may not be overridden; HTML user agents should ignore any author-supplied REL=FORWARD setting.

Navigational Node Links

Navigational nodes are commonly used document objects which are designed by authors to assist the user in navigating through a closed or extended document set. The most familiar and common form of navigational node is a table of contents, which is a well known publishing device used for enumerating and ordering the contents of a closed document set.

NEXT
When REL=NEXT, the target document is the next document in a sequence the author suggests the reader will find useful.
PREVIOUS
When REL=PREVIOUS, the target document is the previous document in a sequence the author suggests the reader will find useful. This is the inverse relationship to REL=NEXT, i.e. REV=NEXT states the same thing as REL=PREVIOUS, similarly, REV=PREVIOUS states the same thing as REL=NEXT.
CONTENTS
When REL=CONTENTS, the target is a table of contents that includes the current document.
INDEX
When REL=INDEX, the target document acts as an index covering the current document.
NAVIGATE
When REL=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.
COLLECTION
When REL=COLLECTION, the target document is an COLLECTION that contains the current document.

When REV=COLLECTION, the current document is a COLLECTION for the referenced document or object.

Hierarchy Links

It is quite common for documents to be developed or defined using a hierarchical model, or tree-like structure. The keywords listed below may be used within HTML documents to identify the hierarchical relationship of closely related nodes, such as the immediate parent, siblings and children. In addition, the TOP keyword may be used to identify the logical top (or root, depending on your perspective) of a hierarchical or tree-like structure.

The entire set of relationships may be used by a user agent to build a map of the hierarchical structure(s) of which the current document is a node. Hypertext links to documents identified with PARENT and TOP values are more likely to be accessible through an icon or other mechanism than documents identified with CHILD or SIBLING.

CHILD
The CHILD relationship identifies a subordinate or subdocument. Any document may have multiple CHILD documents within the same hierarchy.

When REL=CHILD, the target document is a hierarchical child, or subdocument, of the current document.

When REV=CHILD, the current document is the hierarchical child, or subdocument, of the target.

PARENT
The PARENT relationship identifies the superior or container node.

When REL=PARENT, the target document is the hierarchical parent, or container, of the current document.

When REV=PARENT, the current document is the hierarchical parent, or container, of the target.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present an icon in a tool bar.

SIBLING
The SIBLING relationship identifies a sibling in the current hierarchy. Any document may have multiple SIBLING documents within the same hierarchy.

When REL=SIBLING, the target document is a child of a common parent, or a hierarchical peer of the current document.

When REV=SIBLING, the current document is a child of a common parent, or a hierarchical peer of the target document.

TOP or ORIGIN
The TOP relationship identifies the logical top of a hierarchical tree of which the current document is a branch. BEGIN is a functional equivalent to TOP, if only one of these values is specified.

When REL=TOP, the target document is the logical top node of the tree.
When REV=TOP, the current document is the logical top of the tree.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present an icon in a tool bar.

NOTE: ORIGIN has been suggested as an alternative to TOP to provide metaphorical consistency with PARENT/CHILD/SIBLING. Comments are encouraged.

Sequence Links

Given a set of documents, it is possible and often desirable to specify linear sequences to navigate through the set. A book, for example, is often organized as a linear sequence. With sequence links in each document, a user agent can step through or gather an entire book programmatically.

BEGIN or FIRST
The BEGIN relationship identifies the author-defined start of a sequence of documents of which the current document is a node. TOP is a functional equivalent to BEGIN when only one of these values is specified.

When REL=BEGIN, the target document is the beginning of the sequence.
When REV=BEGIN, the current document is the beginning of the sequence.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present an icon in a tool bar.

END or LAST
The END relationship identifies the author-defined end of a sequence of documents of which the current document is a node. TOP is a functional equivalent to END when only one is specified.

When REL=END, the target document is the end of the sequence.
When REV=END, the current document is the end of the sequence.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present an icon in a tool bar.

NEXT
The NEXT relationship identifies the next document in an author-defined sequence of documents, such as a linear book.

When REL=NEXT, the target document is next after the current document.
When REV=NEXT, the current document is next after the target.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present an icon in a tool bar.

PREVIOUS or PREV
The PREVIOUS relationship identifies the previous document in an author-defined sequence of documents, such as a linear book.

When REL=PREVIOUS, the target document is previous to the current document.

When REV=PREVIOUS, the current document is previous to the target.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present an icon in a tool bar.

Related Documents

BIBLIOENTRY
The BIBLIOENTRY relationship identifies a bibliographic entry.

BIBLIOENTRY would most typically be specified on an A element, as it would specify a hypertext link between a citation and a bibliographic entry describing the citation.

    <A REL=BIBLIOENTRY HREF="biblio.html#V.Bush">
        <CITE> As We May Think </CITE> </A>

The resource identified by this link may take any form desired by the author/publisher. A bibliographic entry may be presented in the style of a paper-based bibliographic entry, or it may be presented as the result of a database query.

BIBLIOGRAPHY
The BIBLIOGRAPHY relationship identifies a bibliography.

The resource identified by this link may take any form desired by the author/publisher. A bibliography may be presented as an HTML document which is organized and presented in a style reminiscent of a paper-based bibliography. A bibliography may also be presented as a form-based query into a bibliographic database.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present a labeled icon in a tool bar.

CITATION
The CITATION relationship identifies a bibliographic citation.

When REL=CITATION, the target is a bibliographic citation. The anchor, in this case, may be a bibliographic entry. The anchor may also be a reference, thus allowing the reader a way to locate the citation:

        ... as described by Tim Berners-Lee
        <A REL=CITATION HREF=#TBL> [1] </A>
        ...

When REV=CITATION, the anchor is a citation. Typically, the anchor would also be enclosed within a CITE element as shown in the example below. The example shown here also corresponds to the previous example, serving as its target by use of the NAME attribute.

        ... is described in Tim Berners-Lee's
        <CITE><A NAME=TBL REV=CITATION HREF=./biblio/TBL >
        The HyperText Markup Language </A> </CITE>
        ... 
DEFINITION
The DEFINITION relationship identifies a definition of a term.

Definitions may be, but are not necessarily, contained within a glossary. DEFINITION would most typically be specified on an A element, as it would specify a hypertext link from a term to its definition.

      <A REL=DEFINITION HREF="glossary.html#HTTP"> HTTP </A>
FOOTNOTE
The FOOTNOTE relationship identifies a footnote.

When REL=FOOTNOTE is specified on an A element, the anchor is a footnote marker and the target is a footnote. This can be used to link from the footnote marker (or a highlighted word, phrase, etc.) to an HTML document which contains the footnote text, or to a portion of the same document (see REV=FOOTNOTE).

When REL=FOOTNOTE is specified on a LINK element, it can specify a hypertext link to a set of footnotes which are related to the current document, or to a set of end-notes.

When REV=FOOTNOTE is specified on an A element, the anchor is a footnote; that is, the actual content of the footnote, as opposed to a footnote marker. In this case, the target specified by the HREF value, if any, is the footnote marker.

It has been suggested that the combination of REV=FOOTNOTE and NAME=... on an A element may be used to imply that the enclosed content not be rendered until a link to it is explicitly traversed, at which time it can be presented in a popup window. This would allow for the inclusion of footnote text within a document that would not be visible until the reader wanted it to be presented. Developers of user agents are free to experiment with this proposed feature, but there is no requirement that it be implemented.

GLOSSARY
The GLOSSARY relationship identifies a glossary.

When REL=GLOSSARY, the target document is a glossary.
When REV=GLOSSARY, the current document is a glossary.

If the hypertext link is specified with REL in a LINK element, an HTML user agent may present an icon in a tool bar.

A glossary may be directly presented as an HTML document which is organized and presented in a style reminiscent of a paper-based glossary.

A glossary may also be accessed through an intermediary query mechanism. For example, the user highlights a word or phrase and presses the glossary button, thereby accessing the linked object and passing the highlighted text as an argument. The server returns the glossary entry relevant to the highlighted word.

Meta Relationships

There are classes of information which are not intrinsic to a document, but for which a clear and unambiguous association is often useful or even necessary. This section defines a small set of keywords which are related to ownership and legal notices.

Any attempt to rigorously define a closed set of meta-data classes, types, and formats is doomed to failure, partly due to the need for ongoing experimentation. Hence, the META keyword may be used to identify meta documents which do not necessarily have a clear or unambiguous definition. The content of the target node may be as specific format as a MARC record or an FGDC record, or it may be an author-defined format.

For each of the relationship keywords listed in this section, if the relationship is specified with REL in a LINK element, an HTML user agent may present a labeled icon in a tool bar.

MADE
The REV=MADE relationship has been used to identify the author or "maker" of an HTML document. Typical HREF values include a mailto: URI or the URL of the author's home page.
  <A REV=MADE HREF="mailto:murray@sq.com" > Author </A>
AUTHOR
The AUTHOR relationship identifies a hypertext link to an author.

The hypertext link may be to the author's home page, a biography, an audio or video clip, or an agent which sends mail to the author (i.e., using mailto: ).

COPYRIGHT
The COPYRIGHT relationship identifies a hypertext link to a copyright notice.

While it is arguable whether a copyright notice is required in every HTML file to assert copyright protection on it, there is clearly a desire to express copyright notice among a sufficient portion of the user community to justify support.

A basic copyright notice for this document may simply state: "Copyright 1995 by Murray C. Maloney". It may be desirable, in place of or in addition to such a notice, to have a hypertext link between each HTML document in a set and a single copyright notice, as in the following examples:

      <LINK REL=COPYRIGHT HREF="copyright.html">
        <A REL=COPYRIGHT HREF="copyright.html"> 
                Copyright 1995 by Murray C. Maloney </A>
DISCLAIMER
The DISCLAIMER relationship identifies a hypertext link to a legal disclaimer. Usage is expected to be similar to that of the COPYRIGHT hypertext link. As with the copyright notice, there is no intention or expectation that such a link would be the only way to express a disclaimer.
EDITOR
The EDITOR relationship identifies a hypertext link to an editor. Usage is expected to be similar to that of the AUTHOR hypertext link.
META
The META relationship identifies a hypertext link to a node which contains meta-information related to the current document. This is intended to be a generalized meta-data relationship descriptor.
PUBLISHER
The PUBLISHER relationship identifies a hypertext link to a publisher. Usage is expected to be similar to that of the AUTHOR hypertext link.
TRADEMARK
The TRADEMARK relationship identifies a hypertext link to a trademark notice. Usage is expected to be similar to that of the COPYRIGHT hypertext link.

Other REL and REV Values Under Discussion

There are additional values for use with REL and REV that are currently under discussion.

POINTER
The pointer relationship identifies a hypertext pointer. That is, this is a way to do indirection in HTML.

When REV=POINTER, the anchor is a pointer to the target document. When a hypertext link is traversed to a LINK or A element with REV=POINTER, the target specified by the HREF value should be traversed, and so on, until a target without REV=POINTER is retrieved.

        <LINK NAME=PSEUDO REV=POINTER HREF="real.html">

When REL=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.

STYLESHEET
The STYLESHEET relationship identifies a stylesheet.

When REL=STYLESHEET, the target document is a stylesheet that may be applied to the current document. See WD-style for further information.

TRANSLATION
The TRANSLATION relationship specifies a translation to another language.

When REL=TRANSLATION, the target is a translation to another language. This value will most typically be used with the LINK element, in combination with specification of the target document's language as a LANG attribute value. Presumably, REL=TRANSLATION can be used with the A element to specify a translation of a document fragment, such as a phrase in a foreign language.

When REV=TRANSLATION, the current document, or document fragment, is a translation of the target.

URC
The URC relationship identifies a Universal Resource Citation. This is a proposed format for meta information being developed within the IETF.