BadgeUpdateManager BadgeUpdateManager BadgeUpdateManager BadgeUpdateManager BadgeUpdateManager Class


Creates BadgeUpdater objects that you use to manipulate a tile's badge overlay. This class also provides access to the XML content of the system-provided badge templates so that you can customize that content for use in updating your badges.

public : static class BadgeUpdateManager
static struct winrt::Windows::UI::Notifications::BadgeUpdateManager
public static class BadgeUpdateManager
Public Shared Class BadgeUpdateManager
// This class does not provide a public constructor.

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


The following example shows the use of GetTemplateContent to create the content for a numeric badge and CreateBadgeUpdaterForApplication to send a numeric badge update to the calling app's tile.

function sendBadgeNotification() {
    var Notifications = Windows.UI.Notifications;
    var badgeXml;
    var badgeAttributes;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
    badgeAttributes = badgeXml.getElementsByTagName("badge");
    badgeAttributes[0].setAttribute("value", "7");

    // Create a badge notification from the XML content.
    var badgeNotification = new Notifications.BadgeNotification(badgeXml);

    // Send the badge notification to the app's tile.


Version history

Windows version SDK version Value added
1607 14393 GetForUser


CreateBadgeUpdaterForApplication() CreateBadgeUpdaterForApplication() CreateBadgeUpdaterForApplication() CreateBadgeUpdaterForApplication() CreateBadgeUpdaterForApplication()

Creates and initializes a new instance of the BadgeUpdater, which lets you change the appearance or content of the badge on the calling app's tile.

CreateBadgeUpdaterForApplication(String) CreateBadgeUpdaterForApplication(String) CreateBadgeUpdaterForApplication(String) CreateBadgeUpdaterForApplication(String) CreateBadgeUpdaterForApplication(String)

Creates and initializes a new instance of the BadgeUpdater for a specified app tile's badge, usually the tile of another app in the package. The BadgeUpdater lets you change the appearance or content of that badge.

CreateBadgeUpdaterForSecondaryTile(String) CreateBadgeUpdaterForSecondaryTile(String) CreateBadgeUpdaterForSecondaryTile(String) CreateBadgeUpdaterForSecondaryTile(String) CreateBadgeUpdaterForSecondaryTile(String)

Creates and initializes a new instance of the BadgeUpdater, which enables you to change the appearance or content of a badge on a secondary tile. The tile can belong to the calling app or any other app in the same package.

GetForUser(User) GetForUser(User) GetForUser(User) GetForUser(User) GetForUser(User)

Creates and initializes a new BadgeUpdateManagerForUser for the specified user, which lets you change the appearance or content of the badge on a tile for a specific user.

GetTemplateContent(BadgeTemplateType) GetTemplateContent(BadgeTemplateType) GetTemplateContent(BadgeTemplateType) GetTemplateContent(BadgeTemplateType) GetTemplateContent(BadgeTemplateType)

Gets the XML content of one of the predefined badge templates so that you can customize it for a badge update.

See also