Tokens are written {name}, {name:argument} or {name|modifier} in an element’s text, a progress value, or visibleWhen. See Text and tokens.
Examples below are for Monday 2 November 2026 at 14:05:09, English, 24-hour time.
| Token |
Example |
Notes |
{weekday} |
Monday |
|
{weekdayShort} |
Mon |
|
{day} |
2 |
|
{dayPadded} |
02 |
|
{month} |
11 |
two digits |
{monthName} |
November |
|
{monthShort} |
Nov |
without a trailing period |
{year} |
2026 |
|
{date} |
2026-11-02 |
|
{date:pattern} |
{date:EEE d MMM} → Mon 2 Nov |
any Unicode date pattern |
| Token |
24-hour |
12-hour |
Notes |
{time} |
14:05 |
2:05 PM |
adds seconds with the showSeconds option |
{hour} |
14 |
2 |
|
{minute} |
05 |
05 |
|
{second} |
09 |
09 |
updates every second |
{ampm} |
(empty) |
PM |
|
12-hour time applies when the widget has an option use24Hour set to "false". See Dates and times.
Numbers from 0 to 1, for progress values or with |percent.
| Token |
Example |
{day.progress} |
0.5869 |
{week.progress} |
depends on the first day of the week in your region |
{month.progress} |
0.0529 |
{year.progress} |
0.8372 |
| Token |
Example |
Empty when |
{battery} |
82% |
no battery |
{battery.level} |
0.82 |
no battery |
{batteryState} |
Charging / On Battery |
no battery |
| Token |
Example |
Notes |
{cpu} |
12% |
all cores; empty for the first few seconds |
{cpu.level} |
0.12 |
|
{memory} |
8.1 GB |
memory used, as in Activity Monitor |
{memory.level} |
0.51 |
used ÷ installed |
{memory.total} |
16 GB |
installed memory |
Refreshed every 5 seconds.
| Token |
Example |
Empty when |
{track} |
the song’s title |
nothing playing in Music or Spotify, or paused |
{artist} |
the artist |
same |
{lastTrack} |
the most recent song’s title, even while paused |
nothing has played, or Music or Spotify stopped or quit |
{lastArtist} |
the most recent song’s artist |
same |
| Token |
Example |
Notes |
{weather.temperature} |
21° |
in your region’s unit |
{weather.feelsLike} |
20° |
|
{weather.high} |
24° |
today |
{weather.low} |
15° |
today |
{weather.condition} |
Partly Cloudy |
|
{weather.humidity} |
62% |
|
{weather.location} |
Cupertino |
the city |
Empty until the weather loads, and when no location is available. See Weather.
| Token |
Shows |
{text} |
the value of the option with key text |
{anyKey} |
the value of any option you declare, by its key |
| Token |
Shows |
{script.name} |
the value your script’s update returned as name |
Empty until the script first runs, and if it stops with an error. Requires a script in widget.json. See JavaScript.
| Modifier |
Effect |
Example |
upper |
uppercase |
`{weekday |
lower |
lowercase |
`{monthName |
percent |
0–1 number as a whole percentage |
`{year.progress |
round |
round a number to a whole number |
`{script.temp |
Unknown tokens and modifiers produce a warning and an empty value (or the unchanged value, for modifiers).
The Library and Customize Widgets show example values when real ones are missing, so you can see your whole layout:
| Token |
Preview value |
{battery} / {battery.level} |
82% / 0.82 |
{cpu} / {cpu.level} |
12% / 0.12 |
{memory} / {memory.level} |
8.1 GB / 0.5 |
{track} / {artist} / {lastTrack} / {lastArtist} |
Song Title / Artist |
{weather.*} |
21°, Partly Cloudy, 24°, 15°, 20°, 62%, Cupertino |
The desktop never shows example values.