Link

The HTTP Link entity-header field provides a means for serializing one or more links in HTTP headers. In many cases, it has the same effect as the HTML <link> element.

Note: Some browsers do not support the "icon" relation via HTTP (FF#1185705). Use HTML <link rel="icon"> instead.

Syntax

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

The URI reference, must be enclosed between < and > and URL 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 >:

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

Encoding URLs

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

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

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

http
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