LockScreen (feature extensions schema for Windows 8.1)

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

 

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  

See also

Lock screen overview

How to show notifications on the lock screen

Lock screen apps sample

Requirements

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