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:
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
- Then click on Create on the Worker Overview page.
- Then click on the "Create Worker" button.
- Give your worker a descriptive name. e.g.: prerender-worker
- Click on the Deploy button at the bottom right to initialize the worker.
2. Add the Prerender worker's code
- Click on "Edit Code"
- Replace the example code with the worker's source code
Copy the Cloudflare worker's source code from this link. - Save the changes by clicking on Deploy.
3. Configure the worker
- Step back to the previous interface by clicking on your worker's name on the top left.
- Go to Settings and add the zone and routes for your site.
- Click on +Add at Domains & Routes
- Select route
- 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.
- Select Failure more:
- Click on Add Route to save the setting.
4. Add the Prerender token as an Environment Variable.
- Next to Variables and Secrets, click on +Add
- Copy your Prerender token from your dashboard
Add your Prerender.io Token from the Security and Access menu.
- Add a text variable named "PRERENDER_TOKEN" and set its value to the token from your dashboard. Then, click Deploy.
It might take a couple of minutes for the integration to start working after the final deployment.
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.
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:
- Email: support@prerender.io
- Chat: Available from your Prerender dashboard
Related Articles:
- Available integrations
- CDN Issues
- Edge CDN Status Codes and Behaviour
- How Does Prerender Work With CDNs Like Cloudflare, Fastly, or Akamai?
- How Can I Integrate Prerender If I'm Using a Hosting Platform That Doesn't Allow Direct Server Access?
- How Can I Integrate Prerender With My React/Angular/Vue Application?
- How to Integrate Prerender with WordPress
- Why Am I Seeing 403 or 404 Errors After Integrating Prerender?