Headers: Speculation-Rules

Speculation-Rules header

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Want more support for this feature? Tell us why.

Learn more
See full compatibility

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

The HTTP Speculation-Rules response header provides one or more URLs pointing to text resources containing speculation rule JSON definitions. When the response is an HTML document, these rules will be added to the document's speculation rule set. See the Speculation Rules API for more information.

The resource file containing the speculation rules JSON can have any valid name and extension, but it will be requested with a destination type of speculationrules, and must be served with an application/speculationrules+json MIME type.

Note: This mechanism provides an alternative to specifying the JSON definition inside an inline <script type="speculationrules"> element. Specifying an HTTP header is useful in cases where developers are not able to directly modify the document itself.

Header type	Response header

Syntax

Speculation-Rules: <url-list>

Directives

<url-list>: A comma-separated list of URLs pointing to text resources containing speculation rule JSON definitions. The JSON contained in the text files must follow the same rules as that contained inside inline <script type="speculationrules"> elements. See Speculation rules JSON representation for the syntax reference.

Examples

Speculation-Rules field with a single file

The following response contains one file reference:

Speculation-Rules: "/rules/prefetch.json"

Speculation-Rules field with multiple files

The following response contains multiple file reference as a comma-separated list:

Speculation-Rules: "/rules/prefetch.json","/rules/prerender.json"

Note: The URL values must be contained in quotes.

Specifications

Specification
HTML> # the-speculation-rules-header>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`Speculation-Rules`	121	121	No	107	26.2	121	No	81	26.2	25.0	121	No