coderef

Referrer policyBaseline · Widely available

The Referrer-Policy HTTP header and referrerpolicy HTML attributes control whether requests have the Referer header and what information the header contains.

Supported in all major browsers for at least 30 months — safe to use without fallbacks. Baseline since Sep 20, 2021. Widely available since Mar 20, 2024.

Browser support

DesktopChrome
1–84Not supported
85+Supportedsince Aug 25, 2020
Current: 155
Edge
12–84Not supported
85+Supportedsince Aug 27, 2020
Current: 154
Firefox
1–86Not supported
87+Supportedsince Mar 23, 2021
Current: 157
Safari
1–14.1Not supported
15+Supportedsince Sep 20, 2021
Current: 27
MobileChrome Android
18–84Not supported
85+Supportedsince Aug 25, 2020
Current: 155
Firefox Android
4–86Not supported
87+Supportedsince Mar 23, 2021
Current: 157
Safari iOS
1–14.5Not supported
15+Supportedsince Sep 20, 2021
Current: 27

How to use

This feature is Baseline widely available — use it freely, no fallback needed.

Example

Full syntax and examples are on MDN: referrerPolicy.

Feature detection

JS · check before using
if ("HTMLAnchorElement" in globalThis && "referrerPolicy" in HTMLAnchorElement.prototype) {
  // HTMLAnchorElement.referrerPolicy is available
}

Sub-features

Support for each part of the feature (56). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
HTMLAnchorElement.referrerPolicy52795014525014
HTMLAnchorElement.referrerPolicy.no-referrer-when-downgrade5279✕1452✕14
HTMLAnchorElement.referrerPolicy.origin-when-cross-origin5279✕1452✕14
HTMLAnchorElement.referrerPolicy.unsafe-url5279✕1452✕14
HTMLAreaElement.referrerPolicy52795014.1525014.5
HTMLAreaElement.referrerPolicy.no-referrer-when-downgrade5279✕14.152✕14.5
HTMLAreaElement.referrerPolicy.origin-when-cross-origin5279✕14.152✕14.5
HTMLAreaElement.referrerPolicy.unsafe-url5279✕14.152✕14.5
HTMLIFrameElement.referrerPolicy52795014525014
HTMLIFrameElement.referrerPolicy.no-referrer-when-downgrade5279✕1452✕14
HTMLIFrameElement.referrerPolicy.origin-when-cross-origin5279✕1452✕14
HTMLIFrameElement.referrerPolicy.unsafe-url5279✕1452✕14
HTMLImageElement.referrerPolicy52795014525014
HTMLImageElement.referrerPolicy.no-referrer-when-downgrade5279✕1452✕14
HTMLImageElement.referrerPolicy.origin-when-cross-origin5279✕1452✕14
HTMLImageElement.referrerPolicy.unsafe-url5279✕1452✕14
HTMLLinkElement.referrerPolicy58795014.1585014.5
HTMLLinkElement.referrerPolicy.no-referrer-when-downgrade5879✕14.158✕14.5
HTMLLinkElement.referrerPolicy.origin-when-cross-origin5879✕14.158✕14.5
HTMLLinkElement.referrerPolicy.unsafe-url5879✕14.158✕14.5
Show 36 more
Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
HTMLScriptElement.referrerPolicy70796514706514
HTMLScriptElement.referrerPolicy.no-referrer-when-downgrade7079✕1470✕14
HTMLScriptElement.referrerPolicy.origin-when-cross-origin7079✕1470✕14
HTMLScriptElement.referrerPolicy.unsafe-url7079✕1470✕14
a.referrerpolicy51795014515014
a.referrerpolicy.no-referrer-when-downgrade5179✕✕51✕✕
a.referrerpolicy.origin-when-cross-origin5179✕✕51✕✕
a.referrerpolicy.unsafe-url5179✕✕51✕✕
area.referrerpolicy51795014515014
area.referrerpolicy.no-referrer-when-downgrade5179✕✕51✕✕
area.referrerpolicy.origin-when-cross-origin5179✕✕51✕✕
area.referrerpolicy.unsafe-url5179✕✕51✕✕
iframe.referrerpolicy51795014515014
iframe.referrerpolicy.no-referrer-when-downgrade5179✕✕51✕✕
iframe.referrerpolicy.origin-when-cross-origin5179✕✕51✕✕
iframe.referrerpolicy.unsafe-url5179✕✕51✕✕
img.referrerpolicy51795014515014
img.referrerpolicy.no-referrer-when-downgrade5179✕✕51✕✕
img.referrerpolicy.origin-when-cross-origin5179✕✕51✕✕
img.referrerpolicy.unsafe-url5179✕✕51✕✕
link.referrerpolicy51795014515014
link.referrerpolicy.no-referrer-when-downgrade5179✕✕51✕✕
link.referrerpolicy.origin-when-cross-origin5179✕✕51✕✕
link.referrerpolicy.unsafe-url5179✕✕51✕✕
script.referrerpolicy70796514706514
script.referrerpolicy.no-referrer-when-downgrade7079✕✕70✕✕
script.referrerpolicy.origin-when-cross-origin7079✕✕70✕✕
script.referrerpolicy.unsafe-url7079✕✕70✕✕
http.headers.Referrer-Policy56795011.1565012
http.headers.Referrer-Policy.default_strict-origin-when-cross-origin85858715858715
http.headers.Referrer-Policy.no-referrer-when-downgrade5679✕✕56✕✕
http.headers.Referrer-Policy.origin-when-cross-origin5679✕✕56✕✕
http.headers.Referrer-Policy.same-origin61795211.1615212
http.headers.Referrer-Policy.strict-origin61795211.1615212
http.headers.Referrer-Policy.strict-origin-when-cross-origin61795211.1615212
http.headers.Referrer-Policy.unsafe-url5679✕✕56✕✕