A 500 (Internal Server Error) during file upload with Webflow + Uploadcare integration typically points to an issue with server communication, authentication, or misconfigured widget settings.
1. Check Uploadcare Public Key
- Make sure you are using the correct Uploadcare Public API Key in your integration.
- Log in to Uploadcare, go to Project Settings, and verify the Public Key matches the one embedded in your Webflow form (usually in the Uploadcare widget or custom code).
2. Ensure Proper Uploadcare Widget Installation
- If using the widget via custom code embed, confirm you’ve included the correct script:
https://ucarecdn.com/libs/widget/3.x/uploadcare.full.min.js- The input field should have the correct attribute:
- type="hidden" and attribute role="uploadcare-uploader".
- Ensure you’ve added your public key as a data attribute:
data-public-key="yourpublickey_here".
3. Validate File Size and Format Settings
- Check if the Uploadcare project has any file size limits, MIME type restrictions, or security rules that might be rejecting uploads—causing the 500 error.
- You can tweak security settings in Uploadcare under Project Settings > File Upload Settings.
4. Check Console and Network Logs
- Open DevTools (F12) in your browser, click Network tab, and inspect the failed request.
- Note any descriptive error message from Uploadcare’s server (e.g., unauthorized key, blocked file type).
5. Blocking by Content Security Policy or Ad Blocker
- Webflow’s site may block external scripts if CSP headers are misconfigured. Ensure Uploadcare’s domain is whitelisted if you’ve implemented CSP.
- Disable browser extensions (especially ad blockers or script blockers) to rule out client-side interference.
6. Confirm Webflow Form Setup is Correct
- Even though Uploadcare handles the upload, the remaining form should still be configured correctly:
- Ensure method="POST" and action attributes are correct (if set manually).
- If using Webflow’s default form with Uploadcare, the file URL will be sent via the hidden input; no configuration is needed on Webflow hosting side for upload endpoints.
7. Use Uploadcare's Debug Tools
- Uploadcare offers API logs and usage data under your dashboard. Look under Project > File Upload Logs to see if requests are hitting the server and what’s getting rejected.
Summary
The 500 error usually results from a misconfigured Uploadcare widget, an invalid public key, or upload restrictions in the Uploadcare project settings. Verify your public key, check widget code, and use developer tools and Uploadcare logs to pinpoint the issue.