Skip to content
  • There are no suggestions because the search field is empty.

Cloudflare Integration Guide

If you want to integrate Prerender into your site, the best approach is to incorporate it into your CDN if one is available. This integration specifically uses the ESM JavaScript syntax in Cloudflare Workers.

Video guide:

 

 

 
Cloudflare UI change
The Workers & Pages menu is moved under Compute(Workers).

Prerender token 

The location of the Prerender token has changed. You can find it under the Security and Access menu under Prerender Token.

Copy the Cloudflare worker's source code from this link from here.

It might take a couple of minutes for the integration to start working after the final deployment.

 

Step-by-step guide

1. Create a new worker

  • Open your Cloudflare Dashboard and click on Compute(Workers) and select  Workers & Pages on the left side
    Cloudflare_int tep 1

  • Then click on Create on the Worker Overview page.
    Cloudflare integration step 2

  • Then click on the "Create Worker" button.
    creat  worker CLoudflare

  • Give your worker a descriptive name. e.g.: prerender-worker
    name worker CF

  • Click on the Deploy button at the bottom right to initialize the worker.  
    deploy CF Worker

 

2. Add the Prerender worker's code

 

3. Configure the worker

  • Step back to the previous interface by clicking on your worker's name on the top left. 0aa1cdd6-b87c-4a26-b797-5b8cf5c1f9fe

 

  • Go to Settings and add the zone and routes for your site. 
    add routes to worker

  • Click on +Add at Domains & Routes
    add route2
  • Select route
    add route3

  • Add a Route pattern that matches your site and select the Zone where your site is located.
    Examples of the Route setting: 
Website Address Type Route Pattern
example.com example.com/*
www.example.com www.example.com/*
Both with/without www *example.com/*
Any subdomain *.example.com/*
Specific subdomain blog.example.com/*
Multiple subdomains (sub1|sub2).example.com/*

 

  • You can add a route specific to your subdomain. If you want to test Prerender on just one of your domains or subdomains, you can add another route to the worker later.
    sav route

 

  • Select Failure more:
    image-1737708880656

  • Click on Add Route to save the setting.
    121cd40e-e3d5-434e-b801-be091bc0bfa7

 

4. Add the Prerender token as an Environment Variable.

  • Next to Variables and Secrets, click on +Add
    image-1726832957895

 

 

  • Add a text variable named "PRERENDER_TOKEN" and set its value to the token from your dashboard. Then, click Deploy.
    image-1732791320392
    image-1726833345336

 

It might take a couple of minutes for the integration to start working after the final deployment.

It only works in proxy mode.
This integration will only work if Cloudflare is set up as your proxy.
 
Check the DNS settings for the specified domain and ensure that the A record (or CNAME) is configured to be proxied.

Disable Automatic Signed Exchange (SXGs) in Cloudflare

If you keep the SXGs option enabled, Cloudflare will display the cached version of your website pages to users who click on the page link on the search engine result pages.
However, keep in mind that Prerender is meant to create a static HTML file for search bots, so the rendered version may not be as responsive.
To avoid this issue, we highly recommend disabling this setting in Cloudflare.

You can turn off Automatic Signed Exchanges by going to Speed -> Optimization -> Other (tab) in Cloudflare settings.

image-1707993684604

 

 


 

Verify Your Installation

After integration, it’s important to verify that everything is working as expected. We’ve provided an easy-to-follow guide to help you test your setup and confirm that Prerender is functioning properly.

 

Is the Prerender integration working on other pages?

Test if the Prerender integration works on the other pages based on this guide: Verify the integration

If you don't see the Prerender headers / IDs, then the Integration is not working, which might be why the other URL is not cached. 

 

Getting an Error?

If you see the message "Prerender Integration Not Detected," you can refer to the troubleshooting guide here to help resolve the issue.

 

Expert Assistance

For those who need additional help or want to ensure a smooth and secure launch, we offer a specialized package:

Kickstart Package

Price: $800 (one-time payment)

This one-time package empowers you with expert setup and configuration, ensuring a smooth and secure launch.

Features:

  • Three setup and configuration sessions with our experts
  • Onboarding assistance
  • Security assessment

To learn more about this package or to purchase, visit the Packages section under the Billing menu in your Prerender dashboard. 


 

Get Support

If you're still encountering issues after implementing Prerender:

  • Review your implementation against our documentation
  • Contact our support team:

 

Related Articles: