LockScreen (feature extensions schema for Windows 8.1)

Article
09/20/2021

Defines the badge and notifications that represent the app on the lock screen, which is shown when the system is locked.

Element hierarchy

<VisualElements>: <LockScreen>

Syntax

<LockScreen Notification = "badge" | "badgeAndTileText"
            BadgeLogo    = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. />

Attributes and Elements

Attributes

Attribute	Description	Data type	Required	Default value
BadgeLogo	A logo image that is shown next to the badge to identify the app. This image must be monochromatic, of type .png, and measure 24 x 24 pixels. For more info about how to specify the image in this attribute, see Remarks.	A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", \|, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.	Yes
Notification	The type of tile that can be shown for an app on the lock screen. This can either be simply a badge which displays either a number or a glyph to communicate status, or both a badge and text, which can display detailed status. If LockScreen Notification type 'badgeAndTileText' is selected, then the optional WideLogo must be specified, since only the WideLogo template provides the right information to display with tile text. If this image is not provided, the tile can only display in the square format and cannot accept notifications based on wide template types . This rule is semantically enforced through the manifest API.	This attribute can have one of the following values: badge badgeAndTileText	Yes

BadgeLogo

A logo image that is shown next to the badge to identify the app. This image must be monochromatic, of type .png, and measure 24 x 24 pixels.

For more info about how to specify the image in this attribute, see Remarks.

A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.

Yes

Notification

The type of tile that can be shown for an app on the lock screen. This can either be simply a badge which displays either a number or a glyph to communicate status, or both a badge and text, which can display detailed status. If LockScreen Notification type 'badgeAndTileText' is selected, then the optional WideLogo must be specified, since only the WideLogo template provides the right information to display with tile text. If this image is not provided, the tile can only display in the square format and cannot accept notifications based on wide template types . This rule is semantically enforced through the manifest API.

This attribute can have one of the following values:

badge
badgeAndTileText

Yes

Child Elements

None.

Parent Elements

Parent Element	Description
VisualElements	Describes the visual aspects of the UWP app: its default tile, logo images, text and background colors, initial screen orientation, splash screen, and lock screen tile appearance.

Remarks

For an app to have a presence on the lock screen, it must also register to handle background tasks. For more information, see the Lock screen overview and the BackgroundTasks element.

The BadgeLogo image can be given as either a direct path to an image file or as a resource. By using a resource reference, you can supply images of different scales so that Windows can choose the best size for the device and screen resolution. You can also supply high contrast images for accessibility and localized images to match different UI languages. For more info, see the Globalization topic.

Size requirements of a badge logo image are shown here:

Image attribute Scale Image size in pixels Applications\Application\VisualElements\LockScreen\@BadgeLogo 100 24x24 140 33x33 180 43x43

Requirements

	Value
Namespace	`http://schemas.microsoft.com/appx/2013/manifest`

Share via