Error handling
Rewrite 404 to 200 status code
When enabled, 404 status codes for requests without a file extension are replaced with a 200 status code.Host static single-page applications (SPAs) such as Angular, React, Vue, or
Blazor that rely on
index.html for client-side routing.- Request to
/about(no extension) returns 404 → Rewritten to 200 status code - Request to
/image.jpg(has extension) returns 404 → Remains 404 status code
Navigate to your storage zone
Log in to your Bunny dashboard, go to Storage in the left navigation, and select your storage zone.
Custom 404 file path
Specify a custom file path to serve instead of the standard 404 response. If the custom file does not exist, the standard 404 error will be returned. Example:/bunnycdn_errors/404.html
How it works:
- User requests a file that doesn’t exist
- Storage checks if custom 404 file path is configured
- If configured and the custom file exists, serves that file
- If custom file doesn’t exist, returns standard 404 response
Create your custom 404 file
Upload your custom 404 error page to your storage zone (e.g.,
/bunnycdn_errors/404.html).Navigate to your storage zone
Log in to your Bunny dashboard, go to Storage in the left navigation, and select your storage zone.
- Use a descriptive path like
/bunnycdn_errors/or/errors/ - Include helpful information in your custom 404 page
- Keep the file size small for fast loading
- Test the custom 404 page by requesting a non-existent URL
For single-page applications (SPAs) with client-side routing, enable Rewrite
404 to 200 status code and set 404 File path to
/index.html. This
ensures all routes are handled by your application’s JavaScript router.