<url>

The <url> tag is used to link to an external website. If you are linking to a page within the same document, use <xref> instead.

A <url> may be self-closing, but for accessibility reasons, it is recommended that the <url> wrap text that describes the link. See An Accessible URL for an example.

Syntax

Variants

There are 2 variants of <url>.

Examples

A Minimal URL

A url with no additional information (generally considered bad practice for accessibility reasons).

Visit
<url href="https://www.example.com" />
for more information.

The visual Attribute

A url with the visual attribute set. If the visual attribute is provided and the <url> tag has no content, then the content of the visual attribute will be shown.

Visit
<url href="https://www.example.com" visual="example.com"/>
for more information.

An Accessible URL

A url that has both a simplified form for print (via the visual attribute) and a reasonable text for the web.

Visit the
<url href="https://www.example.com" visual="example.com">example page</url>
for more information.