The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

href attribute | href property

Sets or retrieves a destination URL or an anchor point.

HTML 4.01 Specification, Section 12.2



HTML<element href="p" ... >

p = object.href


Property values

Type: String

the URL or anchor point.

Standards information


When specified for an a element (also called an anchor element), HREF defines a link to another document or another location within the document containing the a element. By default, the text between the opening and closing tags of the anchor element is underlined and the location specified by the HREF attribute is loaded when the user activates the link.

Note  You can use the Cascading Style Sheets (CSS) style rules to modify the appearance of anchor elements.

The value of the HREF can be a URL that loads a separate document when the link is activated, or a fragment identifier. Fragment identifiers, orbookmarks, define target locations within a document that are brought into view when links are activated. Use the NAME attribute of a separate anchor element to define a bookmark as a target location within a document.

Note   Generally, relative URLs are resolved against the location of the document containing the a element. You can use the base element to control the resolution of relative URLs.

For more information on standard Internet protocols such as ftp, http, and mailto, see Predefined Protocols.

The img element does not support the HREF content attribute. In addition, the href property is read-only for the img Document Object Model (DOM) object.

If HREF is specified as a blank value (href="" or href=), executing the link might display the directory containing the current document, or it might generate an error, depending on other elements in the document and the server environment.


This example function returns the href property of the current page location.

function getHref()
    return document.location.href;

See also