VisualElements

Describes the visual aspects of the Windows Store app: its default tile, logo images, text and background colors, initial screen orientation, splash screen, and lock screen tile appearance.

Element hierarchy

<Package>
<Applications>
<Application>
<VisualElements>

Syntax

<VisualElements DisplayName     = A string between 1 and 256 characters in length.
                Logo            = 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.
                SmallLogo       = 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.
                Description     = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
                ForegroundText  = "light" | "dark"
                BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
                ToastCapable?   = boolean >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  )

</VisualElements>

Key

?   optional (zero or one)
&   interleave connector (may occur in any order)

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
BackgroundColor

Specifies the background color of the app tile. See the Remarks section for color names. Note that the background color specified here also applies to these items:

  • The button color in any app-owned dialog boxes
  • The App Description page in the Windows Store
  • Applies to Windows Phone

Choosing "transparent" causes the system accent color to be used.

A three-byte hexadecimal number preceded by "#" or a named color.Yes
Description

The description of the app. This string is localizable; see Remarks for details.

A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.Yes
DisplayName

A friendly name for the app that can be displayed to users. This string is localizable; see Remarks for details.

There are two explicitly reserved words that may not be used as the DisplayName for apps uploaded to the Windows Store: "NoUIEntryPoints" and "NoUIEntryPoints-DesignMode". These identifiers are reserved for use by development tools and test suites.

A string between 1 and 256 characters in length.Yes
ForegroundText

Specifies the foreground color of the app tile.

  • Applies to Windows Phone

This value is ignored. All tiles use the light text color.

This attribute can have one of the following values:

  • light
  • dark
Yes
Logo

An image used as the app's square tile. 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
SmallLogo

A small image shown in the corner of the tile to identify the app. For more info on how to specify the image in this attribute, see Remarks.

  • Applies to Windows Phone

Windows Phone does not display the small logo on the tile. It is used only in the Apps list.

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
ToastCapable

A value of true indicates that the app is allowed to provide toast notifications. The default value is false. If you don't want toast notifications to appear, do not specify a value for this attribute. Note that apps should not make decisions about whether to send toast notifications based on this value.

booleanNo

 

Child Elements

Child ElementDescription
DefaultTile

The default tile that represents the app on the Start screen. This tile is displayed when the app is first installed, before it has received any update notifications. When a tile has no notifications to show, the tile reverts to this default.

InitialRotationPreference

Describes the orientations in which the app would prefer to be shown for the best user experience. On a device that can be rotated, such as a tablet, the app will not be redrawn for orientations that are not specified here. For instance, if the app specifies only Landscape and LandscapeFlipped orientations, and the device is rotated to a Portrait orientation, the app will not rotate.

Note that on devices that can't be rotated, an app might be shown in that device's default orientation and the app's preferred orientation will be ignored. However, on a device with a rotation lock activated, your app's preferred rotation will still be honored.

These orientation preference choices apply to both the splash screen and the app UI when a new session is launched for your app. The preferences can be changed during run time through the AutoRotationPreferences property.

LockScreen

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

SplashScreen

Defines the appearance of the splash screen, which is displayed by the app during launch.

 

Parent Elements

Parent ElementDescription
Application

Represents an app that comprises part of or all of the functionality delivered in the package.

 

Remarks

For more info on tile dimension requirements, see Tile sizes.

Logo and SmallLogo images 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. This feature also allows you to localize the DisplayName and Description attributes. For more info, see the Globalization and Localizing the package manifest topics.

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

Size requirements of two types of logo images are shown here:

Image attributeScaleImage size in pixels
Applications\Application\VisualElements\@Logo 100150x150
140210x210
180270x270
Applications\Application\VisualElements\@SmallLogo10030x30
14042x42
18054x54

 

These are the supported background color names:

aliceBlueantiqueWhiteaquaaquamarineazurebeige
bisqueblackblanchedAlmondblueblueVioletbrown
burlyWoodcadetBluechartreusechocolatecoralcornflowerBlue
cornsilkcrimsoncyandarkBluedarkCyandarkGoldenrod
darkGraydarkGreendarkKhakidarkMagentadarkOliveGreendarkOrange
darkOrchiddarkReddarkSalmondarkSeaGreendarkSlateBluedarkSlateGray
darkTurquoisedarkVioletdeepPinkdeepSkyBluedimGraydodgerBlue
firebrickfloralWhiteforestGreenfuchsiagainsboroghostWhite
goldgoldenrodgraygreengreenYellowhoneydew
hotPinkindianRedindigoivorykhakilavender
lavenderBlushlawnGreenlemonChiffonlightBluelightCorallightCyan
lightGoldenrodYellowlightGreenlightGraylightPinklightSalmonlightSeaGreen
lightSkyBluelightSlateGraylightSteelBluelightYellowlimelimeGreen
linenmagentamaroonmediumAquamarinemediumBluemediumOrchid
mediumPurplemediumSeaGreenmediumSlateBluemediumSpringGreenmediumTurquoisemediumVioletRed
midnightBluemintCreammistyRosemoccasinnavajoWhitenavy
oldLaceoliveoliveDraborangeorangeRedorchid
paleGoldenrodpaleGreenpaleTurquoisepaleVioletRedpapayaWhippeachPuff
perupinkplumpowderBluepurplered
rosyBrownroyalBluesaddleBrownsalmonsandyBrownseaGreen
seaShellsiennasilverskyBlueslateBlueslateGray
snowspringGreensteelBluetantealthistle
tomatotransparentturquoisevioletwheatwhite
whiteSmokeyellowyellowGreen

 

Examples

The following example is taken from the package manifest of an SDK sample.



                    
<Applications>
    <Application Id="App" StartPage="default.html">
        <VisualElements 
            DisplayName="ApplicationDataSample" 
            Logo="images\squareTile-sdk.png" 
            SmallLogo="images\smallTile-sdk.png" 
            Description="Application data sample" 
            ForegroundText="dark" 
            BackgroundColor="#FFFFFF" 
            ToastCapable="false">
            <DefaultTile ShowName="allLogos"/>
            <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
        </VisualElements>
    </Application>
</Applications>
                

See also

App images
Colors class
Quickstart: Creating a default tile using the Visual Studio manifest editor

Requirements

Namespace

http://schemas.microsoft.com/appx/2010/manifest

 

 

Show:
© 2014 Microsoft. All rights reserved.