Email Template Size Limits and Localization Workarounds
Feb 6, 2026
Overview
A specific error occurs when an attempt to update an email template exceeds the maximum allowed payload size of 1,048,576 bytes (1MB):
Payload content length greater than maximum allowed: 1048576
This article explains the size limitations for email templates and provides an alternative solution using a custom email provider Action for complex localization requirements.
Applies To
- Email templates
- Localization
- Custom email provider Action
Solution
To manage email template sizes and localization, follow these steps:
- Maintain the email template below 1 MB to avoid payload errors.
- If the required localization exceeds the size limit, implement a custom email provider Action.
- Configure the Action to send the following attributes to an external Application Programming Interface (API) for translation:
event.notification.message_typeevent.notification.htmlevent.notification.text
- Return the translated content to the Action before final delivery.