HTTPREF
← Back to headers

HTTP Header

Permissions-Policy

Security

Controls which browser features can be used in the current document or its embedded frames.

HTTP header reference, syntax, examples, and developer usage.

What is the Permissions-Policy header?

The Permissions-Policy HTTP header is used to transmit metadata between a client and server as part of HTTP requests or responses.

HTTP headers define how content should be interpreted, cached, authenticated, secured, or processed by browsers and APIs.

Direction

This header may appear in both HTTP requests and responses.

Syntax

Permissions-Policy: feature=(allowlist)

Example

Permissions-Policy: geolocation=(), camera=()

Common use cases

  • Disabling browser capabilities
  • Hardening embedded experiences
  • Controlling powerful features

Common mistakes

  • Using the header in the wrong request or response context
  • Sending invalid header values
  • Incorrect header syntax
  • Assuming the header automatically changes server behaviour

Related headers