How to add a countdown timer to a Customer.io email
Published October 17, 2026 · Customer.io steps checked against its docs on October 17, 2026
Customer.io has several email editors: Design Studio, its newest, and the classic drag-and-drop, rich text and code editors. Each can show an image from a URL you host, which is all a DynaMail timer is. This guide covers Design Studio, then the classic drag-and-drop editor, then the Liquid tag that lets DynaMail count unique opens.

Host the image with DynaMail
A live timer has to stay a link to DynaMail, so the image can be drawn when the email is opened. Customer.io lets you upload images to its Assets library or use images you host yourself. An uploaded copy of a timer is a still picture, so treat the DynaMail URL as a self-hosted image: paste the link, never the file.
Add the timer, step by step
Build the timer and copy its image tag or URL
Set the end date and timezone in the free countdown generator (or the DynaMail dashboard). HTML blocks and code take the image tag; image settings take the URL. Your widget id replaces
YOUR-WIDGET-ID: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;" />Countdown timer URL for an image setting
https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gifOpen the email
Click into the email block of your automation, broadcast or transactional message. A new email starts from scratch or from an existing email; Customer.io suggests Design Studio, its newest editor, for new emails.
Design Studio: an HTML component, or the code editor
In the visual editor, drag an HTML component from the Insert menu onto the canvas and add the tag in the Properties panel. Customer.io says to send a test to make sure your HTML compiles as expected. If you work in code, use the Code / Visual toggle in the header and paste the tag into the code editor, which Customer.io recommends for pasting HTML.
For the plain timer, the Image component also works: Customer.io lets you add a hosted image to Source in the Properties menu. Paste the URL there rather than choosing or uploading a file.
Classic editors: Dynamic image, or the HTML
In the drag-and-drop editor, drag an Image content block onto the canvas. Customer.io’s steps have you pick an asset first for testing; then, under Content Properties, turn Dynamic image on and paste the URL into the Dynamic Url field. This is the field Customer.io documents for image links with Liquid in them.
In the classic code editor, paste the tag into the HTML. In the rich text editor, click HTML to edit the code and paste it there.
Preview, then send a test
In Design Studio, turn on Preview in the canvas toolbar, then click Test > Send test, add up to 25 addresses and click Send. In the classic editors, choose a person in Sample Data and click Send test…; the test fills
customerLiquid with that person’s data. Check that the timer counts down in the inbox.
Optional: count unique opens
DynaMail counts unique opens when the image URL carries a recipient identifier in r=. Customer.io keeps profile attributes under customer, so the email address is {{customer.email}}. Its url_encode filter, documented in both its latest and legacy Liquid, turns cool.person@example.com into cool.person%40example.com, so the tag is {{customer.email | url_encode}}. DynaMail stores a salted hash of it, not the address.
Timer image tag with open tracking
<img src="https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gif?r={{customer.email | url_encode}}" alt="Time left in the sale" width="600" height="196" style="display:block;border:0;" />Timer URL with open tracking, for the Dynamic Url field
https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gif?r={{customer.email | url_encode}}One Customer.io rule matters here: a message fails to send if its Liquid references an attribute the person does not have. The email attribute fills the To line by default, so recipients normally have one. If you put other attributes in the URL, give each a fallback with the default filter, which Customer.io offers in its latest Liquid only.
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 Customer.io 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.
- Customer.io Docs: Choose the right email editor (opens in a new tab)
- Customer.io Docs: Welcome to Design Studio (opens in a new tab)
- Customer.io Docs: Add components to your message (opens in a new tab)
- Customer.io Docs: Understand and style standard components (opens in a new tab)
- Customer.io Docs: Drag-and-drop emails: the basics (opens in a new tab)
- Customer.io Docs: Image requirements (opens in a new tab)
- Customer.io Docs: Liquid syntax list (opens in a new tab)
- Customer.io Docs: Personalize messages with liquid (opens in a new tab)
- Customer.io Docs: Send a test message (Design Studio) (opens in a new tab)
- Customer.io Docs: Test your emails (opens in a new tab)
Frequently asked questions
Does a DynaMail URL meet Customer.io’s image rules?
Customer.io says self-hosted image URLs must end in .jpg, .jpeg, .gif or .png. A DynaMail timer’s path ends in render.gif, with any parameters after it. Customer.io does not say whether it checks the path or the whole URL, so confirm the image in a test send.
Can the Liquid tag make a send fail?
Customer.io fails a message that references an attribute the person does not have. Its email To line is filled from the email attribute by default, so recipients normally have one. If you add other attributes to the URL, give them a fallback with the default filter.
Which Customer.io editor should I use?
Any of them. Design Studio’s HTML component and code editor take the image tag as it is. Its Image component takes a hosted image in Source, and the classic drag-and-drop editor documents a Dynamic Url field for image links with Liquid.
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.