How to add a countdown timer to a Braze email
Published October 17, 2026 · Braze steps checked against its docs on October 17, 2026
The email blocks in Braze’s docs include no countdown timer, but both of its email editors take raw HTML: the drag-and-drop editor has an HTML block, and the HTML editor is code from top to bottom. A DynaMail timer is one image tag, so it fits either. This guide covers both, and the Liquid tag that lets DynaMail count unique opens.

Why an HTML block
A live timer has to stay a link to DynaMail, so the image can be drawn when the email is opened. Braze’s drag-and-drop editor has an Image block with a URL setting for an image hosted elsewhere, but its docs also say Liquid is not supported in image blocks. The HTML block, which Braze describes as raw HTML “recommended for Liquid”, takes the timer with or without a recipient tag, so this guide uses it.
Add the timer, step by step
Build the timer and copy its image tag
Set the end date and timezone in the free countdown generator (or the DynaMail dashboard) and copy the snippet. Your widget id replaces
YOUR-WIDGET-ID:Countdown timer for a Braze HTML block
<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;" />Create the email campaign
Go to Messaging > Campaigns, select Create Campaign, then Email; Braze suggests a Canvas instead for a multi-step journey. Pick the drag-and-drop editor or the HTML editor. Braze recommends one editing experience per campaign.
Drag-and-drop editor: add an HTML block
Under Email Variants, select Edit Email Body. Drag a row into the email from the Rows panel, then drag an HTML block from the Content panel into it. Paste the tag into the block’s HTML property.
HTML editor: paste the tag in the HTML tab
Open the full-screen editor and paste the tag where the timer should appear, in the HTML tab. Braze says the Classic editor “may parse the Liquid as plaintext”, so stay in the HTML tab if you add the recipient tag below. Do not paste it inside an HTML comment: Braze strips comments before it reads Liquid.
Preview as a user, then send a test
Open Preview and Test and use Preview as User with a random, selected or custom user. Braze recommends a test to a real inbox as well, because its preview does not show how email clients render the message, so finish with Test Send and check the timer counts down.
Optional: count unique opens
DynaMail counts unique opens when the image URL carries a recipient identifier in r=. Braze’s email attribute is {{${email_address}}}, and the tag below passes it through the url_param_escape filter, which Braze documents as escaping characters not allowed in URLs “including the ampersand”. The plainer url_escape filter does not list the ampersand, so prefer the parameter form. DynaMail stores a salted hash of the value, not the address.
The tag is {{${email_address} | url_param_escape}}. Type it with straight quotes and braces; Braze warns that curly quotes pasted from other editors can break Liquid.
The same timer with open tracking
<img src="https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.gif?r={{${email_address} | url_param_escape}}" alt="Time left in the sale" width="600" height="196" style="display:block;border:0;" />Braze’s link aliasing adds a lid parameter to links in anchor href attributes. The timer is an image source, not a link, so it is not one of them. If you wrap the timer in a link, only the link gets the parameter.
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 Braze 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.
- Braze Docs: Create an email with drag-and-drop (opens in a new tab)
- Braze Docs: Drag-and-drop editor blocks (opens in a new tab)
- Braze Docs: Create an email with custom HTML (opens in a new tab)
- Braze Docs: Use Liquid (opens in a new tab)
- Braze Docs: Supported Liquid personalization tags (opens in a new tab)
- Braze Docs: Advanced Liquid filters (opens in a new tab)
- Braze Docs: Preview personalization (opens in a new tab)
- Braze Docs: Link aliasing (opens in a new tab)
Frequently asked questions
Does Braze have a built-in countdown timer for email?
Not that we found. The email blocks Braze documents for its drag-and-drop editor are text, lists, buttons, dividers, spacers, images, video, social icons, HTML, menus, NPS surveys and products. A DynaMail timer goes in as an image tag.
Can I use the Braze Image block instead of an HTML block?
For a timer with no Liquid in its link, probably: the Image block has a URL setting for an image hosted elsewhere. Braze’s drag-and-drop docs also say Liquid is not supported in image blocks, so a timer with a recipient tag belongs in an HTML block.
Which Liquid tag goes in the image URL?
{{${email_address} | url_param_escape}}. Braze’s url_param_escape filter escapes every character that is not allowed in a URL, including &, so an address such as maya+news@example.com reaches DynaMail intact.
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.