# Timer

The countdown component is used to create urgency by showing how much time is left until a specific event or offer ends. It’s commonly used for flash sales, product launches, or limited-time promotions.

<figure><img src="/files/8pBJ1BskDDL09cKYH6Ql" alt=""><figcaption></figcaption></figure>

This block is highly customizable and supports personalized messages, dynamic end times, and flexible styling.

### How to set up

<table><thead><tr><th width="186.6822509765625">Settings</th><th width="108.19439697265625" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td>Countdown end date</td><td align="center"><code>text</code></td><td>Sets the final day for the timer using <code>YYYY-MM-DD</code> format.</td></tr><tr><td>End time</td><td align="center"><code>text</code></td><td>Specifies the exact end time in <code>HH:MM</code> format.</td></tr><tr><td>AM/PM</td><td align="center"><code>radio</code></td><td>Sets the period for the end time.</td></tr><tr><td>End of timer message</td><td align="center"><code>richtext</code></td><td>Optional message is shown after the countdown ends. If left empty, the timer hides.</td></tr><tr><td>Digits size</td><td align="center"><code>range</code></td><td>Adjusts the size of countdown digits.</td></tr><tr><td>Heading</td><td align="center"><code>text</code></td><td>Optional heading displayed above the timer.</td></tr><tr><td>Heading size</td><td align="center"><code>range</code></td><td>Controls the size of the heading text.</td></tr><tr><td>Heading style</td><td align="center"><code>select</code></td><td>Choose between heading or body font style.</td></tr><tr><td>Text</td><td align="center"><code>richtext</code></td><td>An optional paragraph under the heading. You can include bold text, emphasis, and links.</td></tr><tr><td>Text size</td><td align="center"><code>range</code></td><td>Control the paragraph text size.</td></tr><tr><td>Background color</td><td align="center"><code>color</code></td><td>Set the background color behind the timer.</td></tr><tr><td>Text</td><td align="center"><code>select</code></td><td>Choose <code>Light</code> or <code>Dark</code> text for readability.</td></tr><tr><td>Text alignment</td><td align="center"><code>select</code></td><td>Align content <code>Left</code> or <code>Centered</code>.</td></tr><tr><td>Padding bottom</td><td align="center"><code>range</code></td><td>Adjust space beneath the block.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://palo-alto.presidiocreative.com/products/blocks/timer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.