Rate this page:

Image Editor

Twilio SendGrid’s Marketing Campaigns provides a built-in image editing tool that allows you to crop, flip, and filter your photos. This article provides an overview of the editor and its features with additional tips to make your images look their best.

Because the Image Editor is available within the Design Library, you can edit images you send with the Email API as well as Marketing Campaigns.

Image Library

You can upload new images and access existing images in the Marketing Campaigns Image Library. Supported file types include .jpg, .gif, and .png. To access the Image Library, navigate to Design Library > Your Images in the sidebar navigation of the SendGrid App. You can also access the Image Library while editing a Single Send or Automation email by adding an image into your content and clicking “Edit Image.”

The Image Library landing page in the SendGrid App. Here you can upload new images or select existing images to edit.

To upload an image, you can either drag an image onto the page where it says, "Drag and drop your images here, or choose images to upload." If you click the "choose images to upload" link, a system dialog will open, allowing you to browse for images on your computer.

Upload a new image to the Image Library

The Image Library displays all images you previously uploaded. You can click any of these images to load a sidebar overlay that displays the image's details. You will also have the option to delete the image, edit the image, or copy the image URL.

A sidbar modal showing an image's details and allowing you to delete the image, edit the image, or copy the image's URL

Image Editor

To access the image editor, open the Image Library and upload a new image or select a pre-existing image that you would like to edit. With an image selected, the detail menu mentioned above should load. Select "Edit Image" from this menu.

The edit button highlighted inside the image details menu

You can also access the Image Editor by editing images already placed in your Single Sends and Automations designs. For more on Email Design, see Working with Marketing Campaigns Email Design

Once in the Image Editor, you will have three primary actions available, "Transform," "Filter," and "Adjust." Each category contains multiple actions that can be performed on your image. More details about these actions is provided below.

When saving edits to your images, a new image will be saved to your Image Library. This allows you to modify an image without overwriting your original photo. You can select "Cancel" at any time to abandon your edits without saving.

You can save images in either the JPG or PNG format. If your image must support transparency, save the file in PNG format. JPG does not support transparency.

The Image Editor landing page shows the top level editor actions on the left and an image preview on the right

Images cannot be larger than 4MB.


The transformation actions include cropping, flipping, and rotating an image.


Cropping an image can change its composition to help communicate your story. Common guidelines for framing and cropping images include the rule of thirds and the golden ratio.

  • Freeform: crop the image to any desired width and height
  • Landscape: crop the image with a fixed 4:3 aspect ratio
  • Portrait: crop the image with a fixed 3:4 aspect ratio

Flip and rotate

  • Rotate: rotate the image 90 degrees clockwise
  • Flip Horizontally
  • Flip Vertically


The provided filters can help quickly alter a photo to create a look and feel without manual adjustments.


The adjustment actions allow you to manually alter multiple image settings. These manual adjustments can be used to modify an unedited photo or to further refine a look after you have applied a filter.

Altering an image's color balance, contrast, and saturation is a powerful way to control your messaging. Color theory is the way designers and artists use color to communicate.

  • Hue: adjust the image's color balance
  • Saturation: adjust the intensity of the hues in the image
  • Brightness: raise or lower the overall luminosity of the image
  • Contrast: adjust the difference between the least and most intense image tones
  • Opacity: control the image's transparency
  • Blur: apply blur to the image
  • Sepia: apply a sepia tone to the image
  • Grayscale: convert the image to grayscale (this is similar to desaturating the image)
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more