Link

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The HTTP Link entity-header field provides a means for serializing one or more links in HTTP headers. It is semantically equivalent to the HTML <link> element.

Syntax

Link: <uri-reference>; param1=value1; param2="value2"
<uri-reference>

The URI reference, must be enclosed between < and > and percent encoded.

Parameters

The link header contains parameters, which are separated with ; and are equivalent to attributes of the <link> element.

Examples

The URI (absolute or relative) must be enclosed between < and >:

Link: <https://example.com>; rel="preconnect"
Link: https://bad.example; rel="preconnect"

Encoding URLs

The URI (absolute or relative) must encode char codes greater than 255:

Link: <https://example.com/%E8%8B%97%E6%9D%A1>; rel="preconnect"
Link: <https://example.com/苗条>; rel="preconnect"

You can specify multiple links separated by commas, for example:

Link: <https://one.example.com>; rel="preconnect", <https://two.example.com>; rel="preconnect", <https://three.example.com>; rel="preconnect"

Specifications

Specification
Web Linking
# header

Browser compatibility

BCD tables only load in the browser

See also