Location href Property

## JavaScript Reference

Overview

## JavaScript Objects

JS Array JS Boolean JS Date JS Math JS Number JS String JS RegExp JS Global

## Browser Objects

Window Navigator Screen History Location

## HTML DOM Objects

DOM Document DOM Elements DOM Attributes DOM Events

## HTML Objects

DOM Anchor DOM Area DOM Base DOM Body DOM Button DOM Form DOM Frame/IFrame DOM Frameset DOM Image DOM Input Button DOM Input Checkbox DOM Input File DOM Input Hidden DOM Input Password DOM Input Radio DOM Input Reset DOM Input Submit DOM Input Text DOM Link DOM Meta DOM Object DOM Option DOM Select DOM Style DOM Table DOM td / th DOM tr DOM Textarea

# Location href Property

Location Object

## Example

Return the entire URL (of the current page):

var x = "URL: " + location.href;
document.getElementById("demo").innerHTML=x;

The result of x will be:

Try it yourself »

## Definition and Usage

The href property sets or returns the entire URL of the current page.

## Browser Support

The href property is supported in all major browsers.

## Syntax

Set the href:

location.href=URL

Return the href:

location.href

## Possible Values

Value | Type | Description
--- | --- | ---

URL

String

Specifies the URL of the link.

Possible values:

- An absolute URL - points to another web site (like location.href="http://www.example.com/default.htm")
- A relative URL - points to a file within a web site (like location.href="default.htm")
- An anchor URL - points to an anchor within a page (like location.href="#top")
- A new protocol - specifies a different protocol (like location.href="ftp://someftpserver.com", location.href="mailto:someone@example.com" or location.href="file://host/path/example.txt")

## Return Value

Type | Description
--- | ---
String | The whole URL

## More Examples

Anchor object
Using the href property for an anchor.

Link to another web site
How to set the href value to point to another web site.

Link to an element with a specified id
How to set the href value to point to an anchor within a page.

Open and create a new email message
How to set the href value to point to a mailto: protocol.

Location Object

## Your suggestion:

Your E-mail (optional):

Page address:

Description:

Close [X]

## Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

## WEB HOSTING

Best Web Hosting UK Reseller Hosting Wow! $5 SSD Hosting

## WEB BUILDING

Download XML Editor
FREE Website BUILDER FREE Website Creator

## WEB RESOURCES

Web Statistics Web Validation

## SHARE THIS PAGE