> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/samita-countdown-timer-bar/countdown-timer/when-the-timer-ends.md).

# When the timer ends

Choose what a countdown timer does when it reaches zero — stay, disappear, or restart.

Every countdown timer needs an ending. The **When countdown timer end** setting, at the bottom of the **Setting timer** section on the **Settings** tab, decides what a shopper sees once the clock hits zero.

<figure><img src="https://855148666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaOJwtwIUCsbYLCDqZD0u%2Fuploads%2Fgit-blob-d9c56e8f2e209331161d609b56a66a71cf1b7374%2Fscreenshot-timer-when-end.png?alt=media" alt="The When countdown timer end setting showing its three options"><figcaption><p>Set the ending in the Setting timer section, below the timing fields.</p></figcaption></figure>

## The three options

| Option                   | What the shopper sees                        |
| ------------------------ | -------------------------------------------- |
| **Do nothing**           | The timer stays on the page, showing zeros   |
| **Hide countdown block** | The whole countdown disappears from the page |
| **Repeat the timer**     | The timer restarts and runs again            |

## Do nothing

The countdown stays exactly where it is, with every number at zero. Nothing else on the page changes — prices, availability and the Add to cart button are untouched, because this app only draws the timer.

This is rarely what you want on a live storefront. A timer frozen at 00:00:00 tells shoppers the offer is over but keeps the block on the page, which reads as neglected more often than urgent. It's useful mainly while you're testing, when you want to see the end state rather than have it vanish.

## Hide countdown block

The countdown removes itself from the page the moment it expires. Shoppers who arrive afterwards see the page exactly as it was before you added the timer.

This is the right default for a real deadline. Set it on any **Countdown to a date** campaign and you don't have to remember to switch anything off when the sale finishes — the timer tidies itself away.

{% hint style="info" %}
Hiding the block doesn't deactivate the countdown. It stays **Active** in the app and will reappear if you extend its End date. To take it out of service entirely, set it to **Draft** from the [Countdowns list](/samita-countdown-timer-bar/countdowns/manage.md).
{% endhint %}

## Repeat the timer

The timer starts over and runs again for the same length.

This only makes sense with **Fixed minutes**, where the timer is a per-visitor window rather than a shared deadline: as soon as a shopper's window closes, a fresh one opens, so they always see a running clock. See [Fixed minutes per visitor](/samita-countdown-timer-bar/countdown-timer/fixed-minutes.md).

{% hint style="warning" %}
A repeating timer is visibly a device, not a deadline. A shopper who reloads and watches it reset knows the urgency isn't real — and Shopify's App Store rules expect countdowns to reflect genuine offers. Use it deliberately.
{% endhint %}

## Which to choose

| Your timer is…                               | Use                                                          |
| -------------------------------------------- | ------------------------------------------------------------ |
| Counting to a real deadline                  | **Hide countdown block**                                     |
| A per-visitor window you want always running | **Repeat the timer**                                         |
| A daily recurring window                     | **Hide countdown block** — it returns on its own next window |
| Being tested in a draft                      | **Do nothing**, so you can see the zero state                |

## Next steps

* [Count down to a date](/samita-countdown-timer-bar/countdown-timer/count-down-to-a-date.md)
* [Fixed minutes per visitor](/samita-countdown-timer-bar/countdown-timer/fixed-minutes.md)
* [Daily recurring timer](/samita-countdown-timer-bar/countdown-timer/daily-recurring.md)
* [Manage countdowns](/samita-countdown-timer-bar/countdowns/manage.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.samita.io/samita-countdown-timer-bar/countdown-timer/when-the-timer-ends.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
