How do I integrate Prerender with Symfony?

TL;DR

YuccaPrerenderBundle connects Prerender to Symfony applications. Install the bundle via Composer, register it in your kernel, configure it with your Prerender token, and AI crawlers and search engines will receive fully rendered HTML instead of a JavaScript shell. This is a community-maintained integration — installation details are in the GitHub README.

⚠️ YuccaPrerenderBundle is community-maintained and is not officially supported by Prerender. For issues with the bundle itself, refer to the GitHub repository.

Step 1: Create a Prerender account and copy your token

Go to prerender.io and create an account if you don't have one. Once logged in, open your Prerender dashboard and copy your Prerender token — you'll need it in Step 3.

ℹ️ Not sure which integration is right for your stack? Ask Nexus, your AI integration assistant, inside your Prerender dashboard — describe your setup and it will recommend the right path and walk you through configuration.

Step 2: Open the YuccaPrerenderBundle repository on GitHub

Go to the YuccaPrerenderBundle repository and read the README. It contains the Composer installation command, bundle registration instructions, and any version compatibility requirements for your Symfony release.

Step 3: Install and register YuccaPrerenderBundle

Follow the installation instructions in the GitHub README to add the bundle to your project via Composer and register it in your Symfony kernel.

When you reach the configuration step, set your Prerender token — the one you copied in Step 1 — as the token value in the bundle's config. This tells Prerender which account to associate cached renders with.

ℹ️ The bundle intercepts requests from AI crawlers and search engines and routes them to Prerender. Your website visitors bypass this flow entirely—their experience is unaffected.

Step 4: Deploy and verify your integration

Deploy your application. Then confirm Prerender is intercepting crawler requests correctly by running the following curl command, replacing the URL with one of your own pages:

curl -v -A googlebot https://www.yourpage.com/

Look for Prerender-specific response headers in the output. If they appear, your integration is active.

✅ Your integration is working when the curl response contains Prerender headers and returns fully rendered HTML—not a JavaScript shell. Cached pages should appear in your Prerender dashboard within 2–5 minutes of the first crawler request.

If you don't see Prerender headers, check your bundle configuration against the README and confirm your Prerender token is set correctly. For the "Prerender Integration Not Detected" error specifically, see What should I do if I receive a "Prerender Integration Not Detected" error?.

💬 Still need help?
If you have questions about configuring or troubleshooting the YuccaPrerenderBundle integration, our support team can help.
→ Contact us at support@prerender.io