TIMEIMAGE
A banner image with an optional "countdown to date" overlay: a title plus boxed day/hour/minute/second fields.
{
"type": "TIMEIMAGE",
"params": {
"url": "https://.../banner.jpg",
"date": "2026-08-01T00:00:00",
"title": "Campaign Ends In",
"title_color": "#FFFFFF",
"title_position": "left",
"position_top": 16,
"position_left": 16
}
}
date— an ISO-8601 string or Unix timestamp (seconds). The countdown overlay only shows while this is in the future; once it passes, the overlay disappears (the image stays).title/title_color— optional label above the countdown box.title_position—"left"(default) or"right", controls which side the overlay aligns to.position_top/position_bottom/position_left/position_right(or a nested"position": { "top": ..., "left": ... }map) — pixel offsets positioning the overlay over the image; defaults to the top-left/bottom-left corner based ontitle_position.
The countdown box shows a day field only when more than 0 days remain, and always shows hours/minutes/seconds.