badge
Specifies a badge's value or glyph.
Element hierarchy
<badge>
Syntax
<badge value = "1-99" | "none" | "activity" | "alert" | "alarm" | "available" | ...
version? = integer />
Key
? optional (zero or one)
Attributes and Elements
Attributes
| Attribute | Description | Data type | Required | Default value |
|---|---|---|---|---|
| value | Either a numeric value or a string value that specifies a predefined badge glyph. Numerically, this value can accept any valid integer. A value of 0 clears the badge, values from 1-99 display as given, and any value greater than 99 displays as 99+. |
This attribute can be set to an integer or have one of the following values:
|
Yes | None |
| version | The version of the badge XML schema this particular payload was developed for. |
integer | No | 1 |
Child Elements
None.
Parent Elements
This outermost (document) element may not be contained by any other elements.
Remarks
This table shows the available status glyphs.
| Status | Glyph | XML |
|---|---|---|
| none | No badge shown | <badge value="none"/> |
| activity |  |
<badge value="activity"/> |
| alarm |  |
<badge value="alarm"/> |
| alert |  |
<badge value="alert"/> |
| attention |  |
<badge value="attention"/> |
| available |  |
<badge value="available"/> |
| away |  |
<badge value="away"/> |
| busy |  |
<badge value="busy"/> |
| error |  |
<badge value="error"/> |
| newMessage |  |
<badge value="newMessage"/> |
| paused |  |
<badge value="paused"/> |
| playing |  |
<badge value="playing"/> |
| unavailable |  |
<badge value="unavailable"/> |
See also
How to send a glyph or numeric badge in a local notification
Guidelines and checklist for tiles and badges
Requirements
| Value | |
|---|---|
| Namespace | http://schemas.microsoft.com/notifications/2012/badge.xsd |