How-to guides

How to add a countdown timer to an Iterable email

Published October 17, 2026 · Iterable steps checked against its support docs on October 17, 2026

Iterable documents this case directly: in its Drag and Drop editor, an Image block with Dynamic image turned on takes a URL from a dynamic image service, and Iterable names countdown timers as one use. This guide pastes a DynaMail timer there, covers the WYSIWYG and Side by Side editors too, and adds the Handlebars tag that lets DynaMail count unique opens.

Countdown timer rendered by DynaMail: a flash sale banner showing the days, hours, minutes and seconds remaining
An example render from DynaMail’s image pipeline. Your design, dates and values will differ.

Link the image, don’t upload it

A live timer has to stay a link to DynaMail, so the image can be drawn when the email is opened. Iterable stores uploaded images in its Creative Library and gives each one its own URL, and its Insert from URL option imports a hosted file the same way. A copied timer is a still picture. Each editor below keeps the DynaMail URL in the email instead.

Add the timer, step by step

  1. Build the timer and copy its URL or image tag

    Set the end date and timezone in the free countdown generator (or the DynaMail dashboard). The Drag and Drop editor’s Image block takes the URL; the other editors take the image tag. Your widget id replaces YOUR-WIDGET-ID:

    Countdown timer URL for a Dynamic URL field

    https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gif

    Countdown timer image tag for HTML

    <img src="https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gif" alt="Time left in the sale" width="600" height="196" style="display:block;border:0;" />
  2. Create the template and choose an editor

    Go to Content > Templates, click New template > Email, name it and click Create template. Then click Edit design and pick an editor. Choose before you build: a Drag and Drop template cannot switch to another editor, and Iterable cannot move a WYSIWYG or Side by Side template into the Drag and Drop editor.

  3. Drag and Drop editor: an Image block with Dynamic image on

    Drag an Image block into the template and select it. In its content properties, turn on Dynamic image and paste the URL into the Dynamic URL field. Iterable’s own example is a dynamic image service URL with a Handlebars expression on the end, which is the shape of the tracked URL further down. An HTML block holding the image tag works too: Iterable’s list of supported HTML tags includes img with src, alt, width and height.

  4. WYSIWYG or Side by Side editor: paste the tag in the HTML

    In the WYSIWYG editor, click Source at the left end of the toolbar and paste the tag where the timer should appear. In the Side by Side editor, paste it into the code editor. Skip the Images button in both: it picks a file from Creative Library.

  5. Preview with user data, then send a proof

    Click Preview, enter the email address of a user in your project and click Load user data. Then use the Send proof menu and choose To yourself. Open the proof in a real inbox and check that the timer counts down.

Optional: count unique opens

DynaMail counts unique opens when the image URL carries a recipient identifier in r=. Iterable’s email field is {{email}}; wrapped in Iterable’s #urlEncode block helper it becomes {{#urlEncode}}{{email}}{{/urlEncode}}, so characters such as + and @ are encoded and the address reaches DynaMail intact. DynaMail stores a salted hash of it, not the address.

Timer URL with open tracking, for a Dynamic URL field

https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gif?r={{#urlEncode}}{{email}}{{/urlEncode}}

Timer image tag with open tracking

<img src="https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gif?r={{#urlEncode}}{{email}}{{/urlEncode}}" alt="Time left in the sale" width="600" height="196" style="display:block;border:0;" />

Iterable field names are case-sensitive, and its Handlebars article warns against commenting out an expression that outputs a value, such as this one, in the HTML source: the value would not render. In a userID-based project you can use userId in place of email inside the helper.

What subscribers will see

  • The time remaining when the image was requested, animated as a GIF.
  • In classic Outlook for Windows, possibly only the first frame, which still shows the correct time. More on Outlook.
  • In Apple Mail, an image that may have been fetched before the email was opened. More on Apple Mail.
  • After the deadline, a timer stopped at zero rather than negative time.

Sources

Every Iterable step above comes from these pages, read on October 17, 2026. Apps rename menus often; if a step no longer matches what you see, the source page is the place to check.

  1. Iterable: Creating Email Templates (opens in a new tab)
  2. Iterable: Drag and Drop Editor (opens in a new tab)
  3. Iterable: WYSIWYG Editor (opens in a new tab)
  4. Iterable: Side by Side Editor (opens in a new tab)
  5. Iterable: Creative Library (opens in a new tab)
  6. Iterable: Personalizing Templates with Handlebars (opens in a new tab)
  7. Iterable: Sending Test Messages (opens in a new tab)

Frequently asked questions

Why not upload the timer to Iterable’s Creative Library?

Creative Library’s Insert from URL option imports the file, and Iterable gives every uploaded file its own Creative Library URL. That copy is a still picture of the timer at the moment of import. Put the DynaMail URL in the email itself instead.

Which Handlebars tag goes in the image URL?

{{#urlEncode}}{{email}}{{/urlEncode}}. Iterable’s #urlEncode helper uses Java’s URLEncoder, so characters such as @ and + are encoded and the address reaches DynaMail intact. Field names are case-sensitive: email, not Email.

Will a proof show the timer?

Yes. A proof sent To yourself fills Handlebars from your own Iterable profile, so the recipient tag resolves to your address and the timer loads just as it will for subscribers.

Will the timer tick in Outlook?

The timer is an animated GIF. Classic Outlook for Windows can show only the first frame, which still shows the time remaining when the image was fetched; it just does not tick. Every other part of the email is unaffected.