If you click the "Save & Test Connection" button in the R2 settings panel and get a connection failure error, please check the following troubleshooting steps:
Common Causes and Solutions:
- Invalid API Token Permissions:
Make sure that when creating the R2 API Token in Cloudflare, you selected "Edit" permission (which allows Read/Write operations) instead of "Read" only. - Incorrect Account ID:
Double-check your Cloudflare Account ID. It should be the alphanumeric string found on your Cloudflare R2 dashboard page, not your profile zone ID. - Bucket Name Typo:
Ensure the bucket name in your settings matches the exact name created in Cloudflare (e.g. "my-site-media" is not the same as "My-Site-Media"). - CORS Configuration:
If your images are not showing up on the website, go to your Cloudflare R2 Bucket settings, scroll to "CORS Policy" and make sure your website domain is allowed to access the objects.