<meta name="referrer">
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The referrer value for the name attribute of the <meta> element controls the HTTP Referer header of requests sent from the document.
If specified, you define the referrer using a content attribute in the <meta> element as a keyword value.
For example, the following <meta> element sends the origin of the document as the referrer:
<meta name="referrer" content="origin" />
Warning:
Dynamically inserting <meta name="referrer"> (with document.write() or appendChild()) makes the referrer behavior unpredictable.
When several conflicting policies are defined, the no-referrer policy is applied.
Usage notes
A <meta name="referrer"> element has the following additional attributes:
content-
Sets the document referrer. You must define this attribute. Accepts one of the following values:
no-referrer-
Does not send an HTTP
Refererheader. origin-
Sends the origin of the document.
no-referrer-when-downgrade-
Sends the full URL when the destination is at least as secure as the current page (HTTP(S)→HTTPS), but sends no referrer when it's less secure (HTTPS→HTTP). This is the default behavior.
origin-when-cross-origin-
Sends the full URL (stripped of parameters) for same-origin requests, but only sends the origin for other cases.
same-origin-
Sends the full URL (stripped of parameters) for same-origin requests. Cross-origin requests will contain no referrer header.
strict-origin-
Sends the origin when the destination is at least as secure as the current page (HTTP(S)→HTTPS), but sends no referrer when it's less secure (HTTPS→HTTP).
strict-origin-when-cross-origin-
Sends the full URL (stripped of parameters) for same-origin requests. Sends the origin when the destination is at least as secure as the current page (HTTP(S)→HTTPS). Otherwise, sends no referrer.
unsafe-URL-
Sends the full URL (stripped of parameters) for same-origin or cross-origin requests.
Examples
>Removing a referrer from requests
The following <meta> element specifies that the document shouldn't send a Referer header with HTTP requests from the document:
<meta name="referrer" content="no-referrer" />
Specifications
| Specification |
|---|
| HTML> # meta-referrer> |
Browser compatibility
Loading…
See also
- HTTP
Refererheader