Widżet statusu

Jeden stan — sprawny, obniżony, niedostępny — niesiony przez ikonę i kolor ważności zamiast liczby.

Fields

Field	Type	Notes
`template`	string	Required. Must be `"status"`
`severity`	string	One of `info`, `warning`, `critical`, `success`. Not required by the server, but the field the template is built around: it picks both the icon and the color
`label`	string	The headline under the icon. Falls back to the widget's `name` when unset. Max 256 characters
`subtitle`	string	Split at `·`, `\|`, `•`, `,` and `;` into tag pills tinted by severity. Max 256 characters
`icon`	string	Overrides the severity icon. SF Symbol name, or an MDI icon prefixed `mdi:`. Max 128 characters
`accent_color`, `background_color`, `text_color`	string	Shared content fields — see the API reference. An explicit `accent_color` overrides the severity color

Example: incident state

PATCH /widgets/incident

{
  "content": {
    "template": "status",
    "severity": "warning",
    "label": "Incident",
    "subtitle": "INC-2841 · api-gateway · investigating",
    "url_action": { "title": "Ack", "icon": "checkmark.circle.fill", "url": "https://example.com/ack/2841" }
  }
}

Behavior

Severity picks the icon as well as the color, and that pairing is deliberate: on the Lock Screen widgets render in a single vibrant tint, so a red circle and a green circle look identical there. The shape is what survives — an octagon for critical, a triangle for warning, a check for success, an "i" for info, and a plain filled circle when severity is unset.

ℹ Info

Setting icon replaces the severity glyph everywhere, including the Lock Screen, so a custom icon costs you that at-a-glance distinction. Use it for a brand or service mark on a widget that stays at one severity, not on one that flips between states.

Severity also tints the whole surface — header hairline, pills, and the action buttons — rather than just the icon, so a critical widget does not end up red with a blue button.

If you find yourself encoding a count into the subtitle ("3 down"), the shape you want is probably stat_list or value. Status is for the state itself.