Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Badge overview (Windows Runtime apps)

Applies to Windows and Windows Phone

A notification badge conveys summary or status information specific to your app. They can be numeric (1-99) or one of a set of system-provided glyphs. Examples of information best conveyed through a badge include network connection status in an online game, user status in a messaging app, number of unread mails in a mail app, and number of new posts in a social media app. Badges can be displayed on all tile sizes. On Windows, they appear in the lower-right corner of the tile (lower-left corner on a computer set to a right-to-left (RTL) language). On Windows Phone 8.1, they appear in the upper-right corner of the tile (upper-left corner on a computer set to a right-to-left (RTL) language).

The following image shows a tile with a numeric badge displaying the number 12 to indicate 12 unread mails.

A tile with a badge

Note  You cannot provide your own badge image; only system-provided badge images can be used.

Specifying a badge

A badge is specified as XML content in a badge update notification. Its elements are defined in the badge schema.

Badge content options

Numeric badges

A badge can display any number from 1 to 99. Any value greater than 99 displays "99+" instead of the actual number. A value of 0 clears the badge from the tile.

ValueBadgeXML
A number from 1 to 99. A value of 0 is equivalent to the glyph value "none" and will clear the badge.A badge displaying the number 1<badge value="1"/>
Any number greater than 99.A badge displaying 99+<badge value="100"/>

 

Glyph badges

Instead of a number, a badge can display one of a non-extensible set of status glyphs.

Windows glyphs

The available glyphs for use with Windows are shown here, together with their XML equivalent in the badge template.

StatusGlyphXML
noneNo badge shown<badge value="none"/>
activityThe activity badge; two circling arrows<badge value="activity"/>
alarmThe alarm badge<badge value="alarm"/>
alertThe alert badge<badge value="alert"/>
attentionThe attention badge; an exclamation point<badge value="attention"/>
availableThe available badge; a green dot<badge value="available"/>
awayThe away badge; a yellow dot<badge value="away"/>
busyThe busy badge; a red dot<badge value="busy"/>
errorThe error badge; an X<badge value="error"/>
newMessageThe new mail badge; an envelope<badge value="newMessage"/>
pausedThe paused badge<badge value="paused"/>
playingThe playing badge<badge value="playing"/>
unavailableThe unavailable badge; a gray dot<badge value="unavailable"/>

 

Windows Phone glyphs

As of Windows Phone 8.1, the available glyphs for use with Windows Phone are shown here, together with their XML equivalent in the badge template. If you send one of the other Windows-supported glyphs, the badge on the phone, if showing, will clear.

StatusGlyphXML
noneNo badge shown<badge value="none"/>
alertThe alert badge<badge value="alert"/>
attentionThe attention badge; an exclamation point<badge value="attention"/>

 

For more information on when and how to use a numeric badge versus a glyph badge, see Guidelines and checklist for tiles and badges.

Related topics

App tiles and badges sample
Badge XML schema
How to send a glyph or numeric badge in a local notification
How to clear a badge
Guidelines and checklist for tiles and badges

 

 

Show:
© 2014 Microsoft