Magento2 Integration Guide

📝 Note: This guide uses Magento 2’s built-in PWA settings and Prerender.io rendering service. No additional middleware is needed.

Video guide:

The required lists are available below the video in the text guide.

Prerender token

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

Text guide:

1. Open your Magento2 admin dashboard

2. Click on STORES Click stores menu in Magento dashboard

3. Click on Configuration Click the Configuration button in the Stores menu

4. Click on Web

Click the "Web" menu in the Configuration menu

5. Access the UPWARD PWA Configuration settings

6. Make sure to check the Use system value box Make sure to have the system default checkbox checked in the UPWARD PWA configuration menu

7. Select Yes from Enable Prerender For Search Bots Select " yes in the Prerender for search bots dropdown list

8. At Prerender URL add https://service.prerender.io/ At the Prerender URL section, add https://service.prerender.io/

9. Add your Prerender.io Token from the Security and Access menu. Find your Prerender token on the Prerender dashboard and add it to the Prerender.io Token section to use the Prerender.io service.

10. Copy and paste the following text into the designated area labeled "Crawler User Agents." Paste the crawler list into the crawler User Agents section in the UPWARD PWA config.

Google-InspectionTool
googlebot
Yahoo
bingbot
yandex
baiduspider
facebookexternalhit
twitterbot
rogerbot
linkedinbot
embedly
quora link preview
showyoubot
outbrain
Pinterest/0.2
developers.google.com/+/web/snippet
slackbot
vkShare
W3C_Validator
redditbot
Applebot
WhatsApp
flipboard
tumblr
bitlybot
SkypeUriPreview
nuzzel
Discordbot
Google Page Speed
Qwantify
pinterestbot
Bitrix link preview
XING-contenttabreceiver
Chrome-Lighthouse
TelegramBot
SeznamBot
Perplexity
OAI-SearchBot
ChatGPT
GPTBot
ClaudeBot
Amazonbot

11. Copy and paste the text into the designated "Blocked List"

*.js
*.css
*.xml
*.less
*.png
*.jpg
*.jpeg
*.svg
*.gif
*.pdf
*.doc
*.txt
*.ico
*.rss
*.zip
*.mp3
*.rar
*.exe
*.wmv
*.doc
*.avi
*.ppt
*.mpg
*.mpeg
*.tif
*.wav
*.mov
*.psd
*.ai
*.xls
*.mp4
*.m4a
*.swf
*.dat
*.dmg
*.iso
*.flv
*.m4v
*.torrent
*.eot
*.ttf
*.otf
*.woff
*.woff2
*.json

12. Click on Save Config at the top right.

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.

Get Support

If you're still encountering issues after implementing Prerender:

Review your implementation against our documentation
Contact our support team:
- Email us at support@prerender.io
- Or click 'Support' > 'Contact Support' at the top-right corner of the dashboard

To help us resolve your issue as quickly as possible, please gather and include any relevant information, such as:

Error messages you're seeing
Steps you've already taken to troubleshoot
Screenshots or screen recordings (if applicable)

Providing these details up front will help our team diagnose the problem more efficiently and get you back on track faster.