Imagery

Guidelines

Images, icons, and illustrations are valuable components of an email. Using them in the right way will not only help enrich the experience, but it will reinforce the emails value. Make sure they relate to the content they are paired with. Don’t just use them to use them. Have a purpose behind them.

Best Practices

How to choose the best image type

  • Photography
    • Use when referring to specific people. This will pull the reader in to feel the human element of the story.
    • Use primarily photographs in B2B emails. For B2B emails, use photography over illustrations where possible. Photography communicates more of a professional vibe that resonates more easily with our B2B customers.
  • Illustrations
    • Use to show concepts. Use illustrations to align the email with the Treehouse brand or to communicate concepts that are often hard or not appropriate to visualize through photography.
    • Make them friendly. Illustrations play a big role in the Treehouse brand because they make the courses feel fun and accessible.
  • Animated GIFs
    • Use GIFs to show product flows. When announcing a new product feature, it's often helpful to show how the feature works. Keep the GIF short so the file size is small. If a longer explanation is needed, use a video.
    • Don't include meme GIFs. This makes Treehouse look unprofessional and the GIFs don't conform to our brand guidelines.
  • Videos
    • Use videos for campaigns or library content. Use videos produced by Treehouse. This can include campaign videos, teasers, course trailers, and the Dev Team Show.

Best Practices

Scaling
  • Keep the aspect ratio. Don't warp the images. Constrain proportions to retain the aspect ratio of the original image.
  • Do

    Do - Constrain proportions

    Do
    Don't

    Don't - Stretch or warp

    Don't
Size
  • Make it retina-ready. Save images at 2x. This ensures retina-ready images. The images will be scaled down to fit. Full width images should be saved at 1200 pixels wide because their max rendered size will be 600 pixels wide. Inline images should be saved at 1032 pixels wide because their max rendered size will be 516 pixels wide.
  • Keep image file size as small as possible. Large file sizes take too long to load. Compress images through a tool such as TinyPNG (actually accepts .jpgs as well as .pngs).
  • Images should be wider than their height. Since the top portion of emails are the most important part of the email, it's important that images don't take up too much vertical space. Keep image height smaller than 516 pixels in height (rendered size; actual retina-ready size is 1032 pixels).
  • Do

    Do - Keep images short

    Do
    Don't

    Don't - Make images too tall

    Don't
User Experience
  • Provide a fallback for background images. Background images don't work in Microsoft Outlook or in Gmail, so provide a background color which is similar to the overall color in the image.
  • Plan for text-only emails. Prepare for the emails to be viewed without images. Include alt text that describes the image. Clients such as Outlook, AOL, and Yahoo have images blocked by default, and in other clients users can turn this on in their preferences.
  • Do

    Do - Plan for blocked images

    Do
    Don't

    Don't - Forget to add alt text

    Don't
  • Don't put text in images. Text is put outside images in order to gain control over readability at small screen sizes. Also, if the user has images blocked in their email client, then they'll miss out on seeing key copy.
  • Do

    Do - Put text outside of images

    Do
    Don't

    Don't - Put text inside images

    Don't
  • Make images link to the CTA when possible. If the image is associated with a CTA, make the image a link to the story-—not to the image itself. Images often take up a lot of real estate on the page, so make use of all that clickable space by including a link. People often instinctively try to click images, so make it easy for them to interact with the email.

Full Width

Vocabulary

Full Width Image

Syntax

Full width photographs span the width of the white section.

Semantics

These are used when you want a section of content to stand out as a featured section.

HTML

<!-- // Card Item: Hero -->
<tr>
  <td class="esg-text-center" align="center">
    <a href="https://teamtreehouse.com" target="_blank">
      <img src="https://gallery.mailchimp.com/6cd557f316f6c6b5deccf9bc0/images/4b4a9744-5efb-47be-a341-978bfc6825ae.jpg" width="600" class="esg-round-t esg-image-full" border="0" alt="Typing on Laptop">
    </a>
  </td>
</tr>
</table>
<!-- // End Card -->

Inline

Vocabulary

Inline Image

Syntax

Inline images sit within the width of the white section, but show padding on the left and right side.

Semantics

These are used to reinforce or expand upon the supporting text.

HTML

<table class="esg-card esg-round" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr>
    <td>
      <a href="https://teamtreehouse.com" target="_blank"><img src="https://gallery.mailchimp.com/6cd557f316f6c6b5deccf9bc0/images/b689c535-f7ff-4550-b4f6-8f69b8f38633.jpg" width="516" class="esg-image-inline esg-p-b-3" alt="Typing on Laptop with Typewriter" border="0"></a>
    </td>
  </tr>
</table>

Attribution

Vocabulary

Attribution, Image Source, Image Credit

Syntax

Attribution lines sit below the right bottom corner of the image.

Semantics

Some images we use require attribution. The attribution line conveys the image source without competing with the other content in the email.

HTML

<!-- // Begin Card -->
<table cellpadding="0" cellspacing="0" border="0" class="esg-card esg-round" bgcolor="#ffffff" width="100%">
  <tr>
    <td class="esg-text-center" align="center">
      <a href="https://teamtreehouse.com" target="_blank">
        <img src="https://gallery.mailchimp.com/6cd557f316f6c6b5deccf9bc0/images/4b4a9744-5efb-47be-a341-978bfc6825ae.jpg" width="600" class="esg-round-t esg-image-full" border="0" alt="Typing on Laptop">
      </a>
    </td>
  </tr>
  <!-- // Begin Attribution -->
  <tr>
    <td colspan="2" class="esg-text-right">
      <p class="esg-p esg-m-t-05 esg-text-color-light esg-text-7 esg-text-right esg-m-b-0">Photo by Daria Nepriakhina / CC0</p>
    </td>
  </tr>
  <!-- // End Attribution -->
</table>

Photography

Vocabulary

Full Width Image

Syntax

Full width photographs span the width of the white section.

Semantics

These are used when you want a section of content to stand out as a featured section.

Choosing the Right Photography

  • In-House Photography. We have some photography that has been made for us. If you need Treehouse employee avatar images for signatures or otherwise, they're in S3 (treehouse-email-images > templates > avatars).
  • Stock Photography. Stock photography is another option.
  • Creative Commons Photography. If using photos that require attribution, such as some Creative Commons photos, follow the attribution guidelines.

Illustrations

Vocabulary

Illustrations

Syntax

Illustrations follow Treehouse's Illustration Guidelines. They can be full width or inline. They're used full-width in featured cards, inline in regular cards, or as thumbnails in call out cards.

Semantics

Illustrations are best used to represent abstract ideas or metaphors. They also reinforce our brand.

Do

Do - Background should have a monochrome color palette.

Do
Don't

Don't - Background shouldn't have multiple hues.

Don't
Do

Do - Shapes should be solid colors

Do
Don't

Don't - Shapes shouldn't have borders

Don't
Do

Do - Shapes should be round

Do
Don't

Don't - Shapes shouldn't have sharp corners

Don't

Animated GIFs

Vocabulary

Animated GIFs, GIFs, animation

Syntax

Animated GIFs

Semantics

Animated GIFs are best used for product walkthroughs and special events or announcements. For the later, they should be produced by the Design or Motion department. Note: Create a fallback for non-supported animated GIFs. Be aware that some clients won't show animated GIFs. Instead, they only show the first frame, so make sure that image makes sense in your layout. Clients that don't support animated GIFs include Outlook (2007, 2010 and 2013) and Windows Phone 7.

Videos

Vocabulary

Video

Syntax

Videos appear in their own section, often with an accompanying title, description, and call to action.

Semantics

Our product largely uses video as a teaching mechanism, so video plays an important role in our communications as well. Short videos, such as video trailers or teasers are perfect for engaging our email audience.

Guidelines

  • Don't embed videos directly into emails. Embedded videos aren't widely supported across email clients. Instead, include a video still and then link that picture to the video so that the video plays in a new tab.
  • Use linked inline image. Add the video still as a regular inline image and wrap it in a link to the video.
  • Choose eye-catching video stills. Choose a moment in the video that features people (ideally - people are more attracted to images with people) or a catchy visual that represents the gist of the video. Don't choose a frame that includes text.
  • Make it look like an app video. Video previews should look like the videos in the Treehouse library. Don't use video previews automatically generated by MailChimp or other ESPs. Use this Photoshop template to make the preview. You can use youtubescreenshot.com to easily generate a video still.
Do

Do - Use the video preview template

Do
Don't

Don't - Use another video preview tool (this is MailChimp's auto-generated one)

Don't
Do

Do - Choose an engaging, text-free video still

Do
Don't

Don't - Use a video still that includes text

Don't

Icons

Vocabulary

Icons

Syntax

Icons appear in lists or alongside copy, in order to reinforce the meaning of the copy.

Semantics

Icons improve the scannability of the email, so users can get the gist of the email without having to read it too closely. They also help relate the email content to the library content by utilizing the same icons across both platforms.

Topics

Android

Android

APIs

APIs

Business

Business

C#

C#

CSS

CSS

Data Analysis

Data Analysis

Databases

Databases

Design

Design

Development Tools

Development Tools

Digital Literacy

Digital Literacy

Game Development

Game Development

Go

Go

HTML

HTML

iOS

iOS

Java

Java

JavaScript

JavaScript

PHP

PHP

Python

Python

Ruby

Ruby

Security

Security

Virtual Reality

Virtual Reality

WordPress

WordPress

_includes/

Concepts

Accessibility

Accessibility

Analytics

Analytics

Data Science

Data Science

Settings

Settings

Events

Events

Featured Student

Featured Student

Getting Started

Getting Started

Information Architecture

Information Architecture

Inside Treehouse

Inside Treehouse

Discover

Discover

Interviews

Interviews

Kids

Kids

Learn To Code

Learn To Code

Marketing

Marketing

New Course

New Course

Announcement

Announcement

Productivity

Productivity

Project Showcase

Project Showcase

QA

QA

SEO

SEO

Profile

Profile

Learning

Learning

Gear Check

Gear Check

Tech News

Tech News

Treehouse Show

Treehouse Show

Tutorial

Tutorial

UI

UI

UX

UX

Video Production

Video Production