← Documentation

For email teams

ESP playbook

Everything you need to drop Dojo Mails timers into Mailchimp, HubSpot-style builders, or raw HTML — without fighting the ESP.

Production URL
Point Dojo Mails at your live site with NEXT_PUBLIC_BASE_URL so embeds use HTTPS and the same host that serves /t/….
Standard vs tracked
Use ?a=1 when you want opens in your analytics dashboard; omit it for maximum caching and simpler URLs.
ESP-ready HTML
Paste a full <img> in Code or HTML blocks — not only drag-and-drop image widgets — so the timer URL stays intact.
Deliverability
Honest alt text, reasonable dimensions for mobile, and awareness that some clients block images until the user enables them.
Step 1
Use your production timer URL
Set NEXT_PUBLIC_BASE_URL in production (e.g. https://dojomails.com) so embed codes match the host serving /t/….

HTTPS is expected by ESPs and inbox providers. Avoid mixing http and https for the same campaign.

Standard vs tracked image
Choose based on whether you need dashboard analytics for opens.
  • Standard — https://YOUR_SITE.com/t/YOUR_SHORT_ID.gifStrong caching; opens are not stored in your analytics dashboard.
  • Tracked — https://YOUR_SITE.com/t/YOUR_SHORT_ID.gif?a=1Append ?a=1 so opens can be counted. See Privacy Policy for what we store.
Generic HTML (any ESP)
Copy, replace YOUR_SITE and YOUR_SHORT_ID, then paste into a code block.
<img src="https://YOUR_SITE.com/t/YOUR_SHORT_ID.gif?a=1"
  alt="Countdown"
  width="400"
  style="display:block;max-width:100%;border:0;" />
Mailchimp
Use a Code or HTML block so you control the full <img> URL — not only the image widget.
Paste the snippet above and replace YOUR_SITE.com and YOUR_SHORT_ID with your values.
HubSpot, Customer.io & similar
Prefer a raw HTML module or custom HTML section in the builder.
Some tools rewrite URLs on send. If the timer stops updating, confirm the src still points to your live /t/ endpoint after the campaign goes out.
Deliverability reminders
Small habits that keep campaigns professional.
  • Use honest alt text; avoid empty or misleading alts.
  • Size GIFs for mobile width so messages stay light.
  • Many clients block images by default — the countdown appears when images load.
Commercial limits
How plans relate to what recipients see.
Paid plans include higher monthly view limits. If a workspace exceeds its limit and your deployment has enforcement enabled, recipients may see a small placeholder image instead of the live timer until the cycle resets or the plan is upgraded. See Pricing for tiers.

Ready to create urgency
that converts?

Join thousands of marketers using Dojo Mails to drive real results. Start free — no credit card required.