bug: OG Image upload throws 500 Server Error

[jammutkarsh]

Error Response:

{
    "error": true,
    "url": "{BASE_URL}/api/upload/image",
    "statusCode": 500,
    "statusMessage": "Server Error",
    "message": "Server Error"
}

This is all I could get from: npx wrangler pages deployment tail --project-name short

POST https://{BASE_URL}/api/upload/image - Ok @ 5/15/2026, 12:10:54 PM
  (error) [request error] [unhandled] [POST] https://{BASE_URL}/api/upload/image
 {
  message: "Cannot read properties of undefined (reading 'put')",
  statusCode: 500
}

[miantiao-me]

Please check if a binding named R2 has been added to r2_buckets. I will work on improving the corresponding error message

[github-actions]

👋 Here are some resources that may help:

📖 From docs: The R2 bucket binding named R2 is required for OG image upload.

• docs/deployment/workers.md (step 4): Run wrangler r2 bucket create sink and ensure r2_buckets is configured in wrangler.jsonc. If you don't need OG images, comment out the r2_buckets section.
• docs/deployment/pages.md (step 6): Bind a variable named R2 to your R2 bucket under Settings → Bindings.
• docs/configuration.md: The NUXT_DISABLE_AUTO_BACKUP section also documents the R2 binding requirement.

The error Cannot read properties of undefined (reading 'put') means cloudflare.env.R2 is undefined — the binding is missing or named differently.

🔗 Related issues:

• Feat: Add support for OpenGraph Images #207: The original feature request that added OG image upload support via R2.

Hope this helps! Feel free to provide more details if these don't address your case.

[jammutkarsh]

Thanks, It's working now!