Contact Us

April 29, 2025

May 13, 2026 4:05 pm

Understanding file upload limits in Salesforce Marketing Cloud

Share with

Understanding the Limits

A community member asked about the limitations of files that can be uploaded to CloudPages, and after conducting some tests, they found that files larger than 1MB were not uploading successfully.

Upon reviewing the documentation, it appears that the official limit for uploading files to Content Builder is 5MB, as stated in the Salesforce documentation. However, it’s possible that the API payload size limit is being reached before the 5MB limit.

To calculate the payload size of an API call, it’s believed to be based on the character length, with each character considered a byte.

The root cause of the issue is likely due to the API payload size limit being reached before the 5MB limit, causing the file upload to fail.

Fixing the Issue

To resolve the issue, it’s recommended to check the timeout value on the API calls and consider setting a lower maximum file size limit, such as 1MB, to prevent timeouts and ensure successful file uploads.

example.html

<input type="file" name="file" maxlength="1048576">

Additionally, it’s essential to handle errors and exceptions properly to provide a better user experience.

Heads up: Make sure to test your file upload functionality thoroughly to ensure it’s working as expected.

Best Practices

Checklist for File Upload Limits

  • Check the official documentation for the latest information on file upload limits.
  • Consider setting a lower maximum file size limit to prevent timeouts.
  • Handle errors and exceptions properly to provide a better user experience.
  • Test your file upload functionality thoroughly to ensure it’s working as expected.
  • Monitor API payload size limits to avoid reaching the limit.
  • Adjust the timeout value on API calls as needed.

What is the official limit for uploading files to Content Builder?

The official limit is 5MB.

How do I calculate the payload size of an API call?

It’s believed to be based on the character length, with each character considered a byte.

What should I do if I’m experiencing issues with file uploads?

Check the timeout value on API calls, consider setting a lower maximum file size limit, and handle errors and exceptions properly.

Where can I find more information on file upload limits?

Check the official Salesforce documentation and consider reaching out to support for more information.

Genetrix Technology · Salesforce Marketing Cloud Partner

Need help shipping this in production?

Genetrix builds and untangles Salesforce Marketing Cloud and Agentforce setups for teams that want it done right the first time. If anything in this post sounds familiar, talk to us before it ships.

Get in Touch with Genetrix →

Blogs for the

Business-Savvy!​

Let’s Connect

A 30 min no cost strategy session
with cloud support expert

Let’s Connect

A 30 min no cost strategy session
with cloud support expert