> For the complete documentation index, see [llms.txt](https://sitesbyseth.gitbook.io/sitesbyseth-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sitesbyseth.gitbook.io/sitesbyseth-docs/reign/sections/urgency-badges.md).

# Urgency Badges

Two live badges that create gentle FOMO:

* **Currently viewing** — "Currently viewing: 23 People", with a number that changes every few seconds
* **Low stock** — "Low Stock. Selling Out Fast" with a pulsing dot

Available as a standalone **Notification badges** section (settings: full width, color scheme, padding — badges configured in the block panel) and as a **Notification badges block** on the product page. Settings are identical:

## Layout & badge style

| Setting                                                               | What it does                 | Default                                |
| --------------------------------------------------------------------- | ---------------------------- | -------------------------------------- |
| Layout                                                                | Vertical stack or Horizontal | Vertical (section) / varies            |
| Alignment                                                             | Left / Center / Right        | Left (section), Center (product block) |
| Gap between badges                                                    | 4–40px                       | 12                                     |
| Section padding top / bottom / horizontal                             | Spacing                      | 20 / 20 / 0                            |
| Border radius / padding vertical / padding horizontal / inner spacing | Badge shape                  | 4 / 10 / 20 / 10                       |
| Font size / weight / letter spacing / text transform                  | Badge typography             | 12 / 400 / 0.5 / Uppercase             |
| Border width / Dot size                                               | Outline + status dot         | 1 / 6                                  |
| Shadow (horizontal, vertical, blur, color)                            | Badge shadow                 | 0 / 1 / 4 / rgba(0,0,0,0.08)           |

## Currently viewing badge

| Setting                                          | What it does                         | Default        |
| ------------------------------------------------ | ------------------------------------ | -------------- |
| Enable badge                                     | On/off                               | On             |
| Font                                             | Typeface                             | Assistant      |
| Text before / after number                       | "Currently viewing:" … "People"      | defaults       |
| Minimum / Maximum number                         | The random range shown               | 5 / 50         |
| Change interval                                  | How often the number updates (1–60s) | 10s            |
| Fade duration                                    | Number-change animation              | 0.5s           |
| Number font weight                               | Emphasis                             | 600            |
| Background / text / number / dot / border colors | Styling                              | light neutrals |

⚠️ **Be honest with the range.** The number is generated within your min/max — it is not real analytics. Keep the range believable for your traffic (a brand-new store showing "200 people viewing" destroys trust). If that doesn't sit right with you, disable this badge and keep only low-stock.

## Low stock badge

| Setting                                 | What it does                  | Default        |
| --------------------------------------- | ----------------------------- | -------------- |
| Enable badge                            | On/off                        | On             |
| Font / Text                             | "Low Stock. Selling Out Fast" | defaults       |
| Background / text / dot / border colors | Styling                       | light neutrals |
| Pulse duration / scale / opacity        | The dot's pulse animation     | 2s / 1.5 / 0.5 |

💡 **Pro tip:** For true scarcity messaging tied to *actual* stock, use the product page's **Inventory status block** (shows "Low stock" below your real threshold, with optional exact counts) — then use these badges purely as visual accents. See [Product page](/sitesbyseth-docs/reign/getting-started/product-page.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 dynamically by asking a question.

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

```
GET https://sitesbyseth.gitbook.io/sitesbyseth-docs/reign/sections/urgency-badges.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.