For the complete documentation index, see llms.txt. This page is also available as Markdown.

Why is Gmail Clipping Emails?

Gmail and some other inbox providers can clip emails that are too long, here is how to troubleshoot your templates.

About Email Clipping

A clipped email is an email that is not fully displayed in your recipient's inbox. This happens when an email's size exceeds 102KB.

Clipped emails are serious because they often hide the footer with the unsubscribe link, increasing spam complaints and damaging your short-term sender reputation.

Troubleshooting Clipped Emails

→ Email HTML Code Weight

All content adds to the total weight, including:

  • Text

  • Links

  • HTML code (including conditional display code)

→ Attached Images

Images can be attached to your emails in two different ways:

  • Enclosed images: Enclosed images are not stored in the template itself. Images are loaded remotely and only the path to the image is referenced in your email template (e.g. <img src="https://path/to/img.png" alt="img"/>). This is Batch's default behavior when you create a template from the email composer.

  • Embedded images: You may also embed an image encoded in Base64 within your HTML template (e.g. <img src="data:image/jpeg;base64,[base64code]" />). Use this approach for small images only, as it adds considerable weight to your template: each Base64 digit represents 6 bits of data. For example, a single 156KB JPEG image will add more than 200K characters to your HTML template.

Best Practices

  1. Move your unsubscribe link to the top of long emails to reduce spam complaints

  2. Minimize email size by:

    • Reducing the number and length of links

    • Condensing text

    • Optimizing HTML code to use fewer characters

Last updated