Permissions-Policy: browsing-topics directive

{{non-standard_header}}{{deprecated_header}}

The HTTP {{HTTPHeader("Permissions-Policy")}} header browsing-topics directive controls access to the Topics API.

Where a policy specifically disallows the use of the Topics API, any attempts to call the {{domxref("Document.browsingTopics()")}} method or send a request with a {{httpheader("Sec-Browsing-Topics")}} header will fail with a NotAllowedError {{domxref("DOMException")}}.

Syntax

Permissions-Policy: browsing-topics=<allowlist>;

• <allowlist>
  • : A list of origins for which permission is granted to use the feature. See Permissions-Policy > Syntax for more details.

Default policy

The default allowlist for browsing-topics is *.

Specifications

This feature is not part of an official standard, although it is specified in the Topics API Unofficial Proposal Draft.

Browser compatibility

{{Compat}}

See also

• {{HTTPHeader("Permissions-Policy")}} header
• Permissions Policy
• Topics API
• {{domxref("Document.browsingTopics()")}}