How can I resolve the 500 (Internal Server Error) I am encountering while trying to upload a file into a form using Webflow with uploadcare integration?

TL;DR
  • Verify the correct Uploadcare public API key is used and properly embedded in the widget or form.  
  • Ensure the Uploadcare widget script and input attributes are correctly set in custom code.  
  • Check Uploadcare project settings for file size, MIME type, or security restrictions.  
  • Use browser DevTools to inspect network errors and Uploadcare logs to identify rejected requests.  
  • Confirm browser extensions or CSP headers aren't blocking the widget's functionality.  
  • Make sure the Webflow form is correctly set up for POST submissions and hidden inputs.

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.

Rate this answer

Other Webflow Questions