🌟 NEW: You can now add image galleries & embed Tweets in your emails! This tutorial has been updated accordingly.

This is part 3 of a 3-part series about the ConvertKit email editor:

  1. The Email Editor: Overview + FAQs

  2. The Email Editor: Text Formatting

  3. The Email Editor: Adding Media —📍You are here!

How to add images (& more) to ConvertKit emails

There are several different types of media you can add to your ConvertKit emails! Images are one, of course — but also video (in an email-friendly way!), HTML, and more.

In this article we'll cover each media option, as well as the settings they each have available. Let's jump in!

NOTE: Just working with words for now? We have a separate guide dedicated to text formatting here.


If you select 'Image' from the content block menu (more info on that menu & how to access it here), and you'll be prompted to upload your own file, choose from a selection your recently uploaded images, or select from one of our integrations on the left sidebar.

Once your image is added to the email editor, click on it to reveal a menu of additional formatting options:

From this menu you can add alt text, add a URL to turn your image into a link, and adjust some visual styles on the right (which includes the option to enable text wrapping).

You can even click the 'Edit image' button to use our built-in image editor and make edits directly within ConvertKit!

Image Galleries (new! 🌟)

You can now showcase a curated gallery of images in your broadcast! This feature is very similar to image galleries on landing pages.

Select 'Image Gallery' from the content block menu, and populate the placeholders with images of your choosing:

NOTE: The 'Image gallery' heading won't display in your actual email.

To adjust the styling of your image gallery, click its 'Settings' button from the top right. From the sidebar, you'll be able to adjust the corner radius, number of columns, crop, and caption text styling:

To adjust the settings for a particular image, click on it directly to populate image-specific options on the sidebar. From there you can edit the image using our built-in editor, replace it, remove it, select whether to optimize it, add a URL to turn it into a link, and adjust the alt text:


You can add links to files, such as PDFs, in your emails that your subscribers can download by clicking on them.

You have two options here: you can select 'File' from the content block menu in an empty block, and you'll be prompted to select which file you want to upload from your computer. This method will insert the file as a text link, using the filename. For example:

If you want to customize the linked text instead of using the filename, then first just type your text as a normal paragraph. Then highlight it > select the content block menu > select 'File' under the 'Insert' menu:

Then upload your file when prompted, and voilà! Now, your custom text is linked to the file, instead of the filename.


Videos can't be directly embedded in ConvertKit emails, because most email editors don't like it. Our recommendation instead is to insert a screenshot that is linked to your video.

If your video is on YouTube, the 'Video' option from the content block menu will do this automatically for you, using our YouTube integration:

If your video isn't on YouTube, simply upload a screenshot of it using the 'Image' option from the content block menu, then add the video link to the URL field of the image menu (see 'Images' section above).

NOTE: If you'd like to see us integrate with more video hosting providers, please let us know which ones with a feature request in our community here!


The 'Divider' option will insert a subtle grey separator into your email:

This is a great way to visually split up different sections.

HTML Blocks

Selecting 'HTML Block' from the content block menu will insert an empty HTML block in your email:

Click the red 'Edit' button and enter your HTML in the modal that pops up:

When you're done, click 'Save'.

NOTE: You can also add inline CSS to an HTML block. The process is the same as adding it to an email template (more on that here); you're just doing it in a specific email instead.

Twitter Embeds (new! 🌟)

You can now embed Tweets directly in your emails! (And on landing pages, too.) We have a separate tutorial on this here.


Content snippets are a great way to dynamically add re-usable content to your emails! We have a dedicated guide to using content snippets here, and when your snippet is ready, you can insert it into any email by selecting 'Snippet' from the content block menu.

The Email Editor: Text Formatting

Did this answer your question?