导航|地址|刷新
Speed Brain

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/speed/llms.txt
Use this file to discover all available pages before exploring further.



DocsDirectoryAPISDKsChangelog

Search

Log in






Speed

/




Overview


Observatory (beta)Beta


Overview

Observatory dashboard

Run test

Understand test results

RUM beacon for Web Analytics

FAQ





Origin Analytics


Settings


Recommendations

Measurement


Image optimization


Image Resizing ↗

Polish ↗

MirageDeprecated


Troubleshooting


Image optimization on optimized images

Polish statuses ↗

Troubleshoot missing images










Content optimizations


Automatic Platform Optimization ↗

Content compression

Shared dictionariesBeta


Cloudflare FontsBeta


Overview

FAQ

Troubleshooting





Early Hints ↗

Prefetch URLs


Rocket Loader


Overview

Enable

Ignore JavaScripts





Smart Hints

Speed BrainBeta


Troubleshooting


Content encoding issues

Turn off Auto Minify










Protocol optimization


HTTP/2

HTTP/3 (with QUIC)

Enhanced HTTP/2 Prioritization

0-RTT Connection Resumption


Troubleshooting


Enhanced HTTP/2 Prioritization negatively affects iOS/Safari devices

Troubleshoot protocol issues





HTTP/2 to Origin









Smart Shield ↗

Troubleshooting

Aggregated Internet Measurement

Glossary


Agent resources


Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Speed llms.txt ↗

Speed llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗













Home

/Speed

/…
Settings


/Content optimizations

/Speed Brain



Speed Brain


Last updated Jun 5, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewAvailabilityRequirementsWhat is Speed Brain?How Speed Brain worksTest Speed BrainRUM integrationEnable and disable Speed BrainCaveats




Speed Brain is a tool for improving web page performance by prefetching the most likely next navigation.

------


Availability

	Free	Pro	Business	Enterprise
Availability	Enabled by default	Yes	Yes	Yes

------


Requirements


Speed Brain works under the following conditions:

The Speed Brain feature is enabled in Cloudflare.

The browser of the web page visitor is using a Chromium-based browser version 121 or later.

The web page requested by the prefetch is eligible for cache.

The page requested by the prefetch does not invoke a Worker.


What is Speed Brain?


The overall goal of Speed Brain is to try to download a webpage to the browser before a user navigates to it.

Cloudflare leverages the Speculation Rules API ↗ to improve web page performance by instructing the browser to consider prefetching future navigations. Speed Brain does not improve page load time for the first page that is visited on a website, but it can improve it for subsequent web pages that are navigated to on the same site.

By prefetching pages that the browser considers likely to be navigated to, Speed Brain can enhance key metrics like Largest Content Paint ↗ (LCP), Time to First Byte ↗ (TTFB) and overall page load time.


How Speed Brain works


When Cloudflare's Speed Brain feature is enabled, an HTTP header called Speculation-Rules is added to web page responses. The value for this header is a URL that hosts an opinionated Speculation-Rules configuration. This configuration instructs the browser to consider prefetching any future navigations with a conservativeeagerness ↗.

The configuration looks like this:
{ "prefetch": [ { "source": "document", "where": { "and": [{ "href_matches": "/*", "relative_to": "document" }] }, "eagerness": "conservative" } ]}
This configuration instructs the browser to initiate prefetch requests for future navigations. These prefetch requests will include the sec-purpose: prefetch HTTP request header. Prefetches that are not successful will respond with a 503 status code. Prefetches that are successful will respond with a 200 status code.


Test Speed Brain


To test that Speed Brain is enabled, you can check that your HTTP response headers for your web pages include the Speculation-Rules header. However, note that during the beta phase of Speed Brain, this behavior might not be 100% consistent.

To test whether your browser is making prefetch requests, open the Network tab in Chrome DevTools. Then, mouse-down on a link on a webpage with Speed Brain enabled. This action should initiate a prefetch request, which will be  visible in the Network tab. However, note that there are several reasons why the browser might choose not to initiate a prefetch. Refer to the Chrome Limits guide ↗ for more details. For more general information about debugging Speculation-Rules, refer to the Chrome Speculation Debugging guide ↗.


RUM integration


Speed Brain is designed to integrate with Web Analytics & Real User Measurements (RUM). This integration allows you to understand the web performance implications of Speed Brain within the Web Analytics interface in Cloudflare's Dashboard.

While you can use Speed Brain without RUM enabled, you will not have visibility into how the feature is affecting the performance of your web pages. For further details on how to set up RUM, refer to the Web Analytics & RUM documentation.


Enable and disable Speed Brain


Speed Brain is available in Cloudflare's Speed tab of the dashboard and also in the API.






To enable or disable Speed Brain in the dashboard:


In the Cloudflare dashboard, go to the Speed > Settings page.
Go to Settings ↗


Go to Content Optimization.



Toggle Speed Brain to On or Off.




Use the following PATCH request to enable Speed Brain:

Required API token permissions
At least one of the following token permissions is required:
Zone Settings Write
Change Cloudflare Speed Brain settingbashcurl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/speed_brain" \ --request PATCH \ --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ --json '{ "value": "on" }'
To disable Speed Brain, set value: to "off".



You can also configure Speed Brain using Terraform. For more details, refer to the cloudflare_zone_settings_override resource in the Terraform documentation ↗.





Caveats



Since prefetch responses are not guaranteed to be rendered by the browser, Speed Brain includes two safeguards to minimize the risk of unsafe prefetching ↗:


Speed Brain will not prefetch on routes that run Workers. Without this safeguard, prefetch requests could inadvertently run Worker logic that assumes the incoming request is a normal (that is, not a prefetch) request. An example of this could be an incrementing page view counter running in a Worker. A page view counter should not increment if the page is not actually rendered in the browser.



Prefetch requests will never reach origin servers. Prefetch requests only serve content that is stored in Cloudflare’s Cache. If the content is not in Cache, the prefetch request will not continue to origin servers. Without this safeguard, origin server state could be modified despite the prefetch response not being rendered in the browser. An example of this could be a prefetch GET request to a sign-out URL inadvertently triggering a sign-out action on the server.




If origin server responses include the Speculation-Rules header, it will not be overridden.



Speed Brain will not work with restrictive Content Security Policy ↗ configurations using strict-dynamic or nonce-{hash} attributes.



Currently, Speed Brain is not compatible with websites that use or rely on pages.dev.



PreviousIgnore JavaScriptsNextContent encoding issues


Was this helpful?

YesNo

Edit pageReport issue




On this page

Overview

Availability

Requirements

What is Speed Brain?

How Speed Brain works

Test Speed Brain

RUM integration

Enable and disable Speed Brain

Caveats


Edit pageReport issue














Getting started
PlansContact salesPartnersFind a partnerStartupsUnder attack?Domain name search


Company
AboutCareersInvestorsPressPress kitGlobal network




Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG


Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse




Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog


Developers
DocumentationLearning centerCommunity




Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform


Start BuildingLog In












© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices








Docs




------
导航页 打开网址