For the greatest degree of flexibility in designing your Gmail ads, use custom HTML. Suitable for advanced advertisers, custom HTML lets you create ads different from existing Gmail ad templates. These ads can include embedded forms, video, phone numbers, and multiple calls-to-action. To create Gmail ads with your own customized layout, upload your own custom HTML files into AdWords.
The details below explain how to configure and upload your custom Gmail ads.
Before you begin
If you want to use a template, go to Create Gmail ads with templates. Note that template ads can include YouTube videos.
Important: Keep in mind that custom HTML Gmail ads retain a destination URL formatting, and are incompatible with final URLs and tracking templates. Learn more about Upgraded URLs.
A custom HTML Gmail ad is a ZIP folder that contains all the files for your collapsed and expanded ad. To avoid problems, pay close attention to the strict formatting specifications detailed below.
The overall size limits of your ad are the following:
How to create your collapsed ad
For your collapsed ad, you’ll add 2 files to your ZIP folder:
Logo image specifications
The file must be named exactly “logo.png,” “logo.jpg,” or “logo.gif” and the file format must be PNG, JPG, or GIF.
Logo image size: < 144 x 144
File size: < 150KB
File formats: PNG, JPG, or GIF (non-animated)
The logo image is a small icon, graphic or brand logo.
The image will be displayed as a 50 x 50 square on normal resolution devices, but we accept up to 150KB for clearer viewing on some screens
Text file specifications
The file must be named exactly “teaser.txt” and the file format must be TXT. Here’s an example of a properly formatted text file.
Advertiser: Business Name
Subject: Everything 20% Off at Business Name
Description: Buy new products at low prices!
Display Url: www.example.com
Landing Page: https://www.example.com/sale
Note: Follow the example exactly and be sure to enter the headings in English exactly as shown below. Also, be sure to include both the category (like “Advertiser”) and your specific information. The table below gives character limits and more guidance about what to include.
Please review Google’s editorial policies
Google advertising policies help
How to create your expanded ad
For your expanded ad, you’ll add 1 HTML file and 1 image folder to your ZIP folder:
Image folder specifications
HTML file specifications
Markup not permitted
Add a video to your expanded ad HTML file
How to add a video
A YouTube video can be embedded into an ad with a preview window. When someone using a computer clicks the video image, the video will play in a lightbox within Gmail. After the user is done watching the video, they are returned to the Gmail expanded ad. On mobile, the video will play on the person’s designated video player (like the YouTube app or a browser).
Instructions: To add video from YouTube, code the YouTube link, image source, and display text to be appropriate for your ad. For example:
<a href="http://www.youtube.com/watch?v=oHg5SJYRHA0"><img src="images/play.jpg" alt="Gmail Video"></a>
Note: When you preview the ad in AdWords, the YouTube video will not show or play in the lightbox.
How to add a video in new tab
If you want the video to play in YouTube in a new tab, rather than in a lightbox, set the class as "nonplayable.”
<a href="http://www.youtube.com/watch?v=oHg5SJYRHA0" class="nonplayable"><img src="images/play.jpg" alt="Gmail Video"></a>
Important: include a “play” button in your preview image.
To show people that clicking the image will play a video, your preview image should include some type of play button. AdWords does not add anything to preview images to indicate that they are videos.
How to remove ad overlays from your embedded videos
Within the host YouTube account, you can disable ads on top of your videos. Learn more