# Label Widget

The Label Overlay Widget allows you to display persistent information for your stream that will automatically update as changes occur. Common examples are for showing the latest follower, subscriber, donation, etc.

## Label Display Settings

When building a Label Overlay Widget, you can select from one of the following options for how the labels will be displayed:

- **Rotation Displays:** The label displayed will rotate between each of the enabled label types automatically based on the number of seconds specified.
- **Newest Only:** The label displayed will always be the label type that was most recently updated and will not change until the same one or a different one has had its value updated.

## Label Types

The following are the list of supported label types:

- **Viewer Count:** Displays the amount of viewers watching you across all your connected platforms.
- **Chatter Count:** Displays the amount of actively detected chatters across all your connected platforms.
- **Latest Follower:** Displays the username of the latest user to follow your channel / become a YouTube subscriber.
- **Total Followers:** Displays the total number of followers / YouTube subscribers.
- **Latest Subscriber:** Displays the username of the latest user who subscribed to your channel / became a YouTube member.
- **Total Subscribers:** Displays the total number of subscribers / YouTube members.
- **Latest Raid:** Displays the username and amount of viewers of the latest raid on your channel.
- **Latest Donation:** Displays the username and the amount of the latest donation.
- **Latest Twitch Bits:** Displays the username and amount of the latest Twitch Bits cheered.
- **Latest Kick Kicks:** Displays the username and amount of the latest Kick kicks
- **Latest YouTube Super Chat:** Displays the username and amount of the latest YouTube Super Chat.
- **Latest Subscription Gifter:** Displays the username of the latest user to gift a subscription.
- **Latest Velora Cheered:** Displays the username and amount of the latest Velora cheer.
- **Latest VPZone Cheered:** Displays the username and amount of the latest VPZone Pixels cheer.

- **Counter:** Displays the amount of the selected counter. This will automatically update as changes are made to the counter.
- **File:** Displays the contents of the selected text file. This will automatically update as changes are made to the text file.
- **Date:** Displays the current date, updating live in the overlay. See [Date & Time Labels](/docs/overlays/label#date--time-labels) below.
- **Time:** Displays the current time, updating live in the overlay. See [Date & Time Labels](/docs/overlays/label#date--time-labels) below.
- **Custom Text:** Displays whatever text you put in the format, which is re-evaluated once a minute so any [Special Identifiers](/docs/reference/special-identifiers) in it stay current.

## Label Type Formats

All label types have a default format specified for that containing the common information you will want. You can further use [Special Identifiers](/docs/reference/special-identifiers) in the format as well, including user-specific Special Identifiers for the user displayed in that label where applicable (EX: $username will show the name of the user that followed for the Latest Follower label type).

The Viewer Count, Chatter Count, and Custom Text label types are checked once a minute rather than being told when something happened. They only push an update when the text they resolve to has actually changed, so in Newest Only mode a display with nothing new to report will not take over the label every minute.

## Date & Time Labels

Date and Time labels are rendered in the browser and re-drawn every second, so the clock on your overlay ticks without Mix It Up having to send an update for each one.

The format accepts the following tokens:

| Token | Meaning |
| --- | --- |
| `YYYY` `YY` | Year |
| `MMMM` `MMM` `MM` `M` | Month |
| `DD` `D` | Day |
| `dddd` `ddd` | Weekday |
| `HH` `H` | Hour, 24-hour |
| `hh` `h` | Hour, 12-hour |
| `mm` `m` | Minute |
| `ss` `s` | Second |
| `A` `a` | AM/PM |

Wrap any literal wording in square brackets so its letters are left out of the date formatting. For example, `h:mm A [in Las Vegas]` shows the time followed by the words rather than trying to read the D in "Vegas" as a day.

### Time Zone

Date and Time labels have an optional Time Zone, so a label can show the clock for somewhere other than the computer running the overlay. Daylight saving is applied for you and localized. Leave it blank to use the time zone of the machine the overlay is running on.

Zones are listed under their primary city, so Europe/Berlin also covers Amsterdam and Rome. You can also type any IANA time zone name directly, such as `Europe/Amsterdam`.

### Styling Individual Parts

Each rendered part of a Date or Time label is wrapped in its own span named after the token that produced it, so pieces can be styled on their own from the widget's CSS section. The class carries the case of the token, so `.date-MM` is the month and `.time-mm` is the minute.

- `.date-MMMM` targets the month name
- `.time-A` targets the AM/PM
- `[class^="date-"]` or `[class^="time-"]` covers a whole group at once

## Entrance & Exit Animations

The Label widget has its own Entrance and Exit animations, played when the display shown on the label changes. These run in both Rotating Displays and Newest Only modes.