DefaultTile

This topic has not yet been rated - Rate this topic

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.

Element hierarchy

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

Syntax

<DefaultTile WideLogo?  = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", /, \, |, ?, or *.
             ShortName? = A string between 1 and 40 characters in length.
             ShowName?  = "allLogos" | "noLogos" | "logoOnly" | "wideLogoOnly" />

Key

?   optional (zero or one)

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
ShortName

A short name for the app that is displayed directly on the tile. This string is localizable; see Remarks for details.

A string between 1 and 40 characters in length.No
ShowName

The tile sizes, as expressed by their logo size, that should display the app's short name: square only, wide only, both, or neither.

This attribute can have one of the following values:

  • allLogos
  • noLogos
  • logoOnly
  • wideLogoOnly
No
WideLogo

A wide version of the logo image. This image is displayed when the tile is displayed in its wide format. If this image is not provided, the tile can only display in the square format and cannot accept notifications based on wide template types. The user has the ultimate choice as to which format the tile uses, so it is a best practice to include a wide logo image. If a wide logo image is provided, the tile will be shown initially in its wide format. For more info about required logo dimensions, see Tile sizes.

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 cannot contain these characters: <, >, :, ", /, \, |, ?, or *.No

 

Child Elements

None.

Parent Elements

Parent ElementDescription
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.

 

Remarks

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

WideLogo 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. This feature also allows you to localize the ShortName attribute. For more info, see the Globalization and Localizing the package manifest topics.

Size requirements of a wide logo image are shown here:

Image attributeScaleImage size in pixels
Applications\Application\VisualElements\DefaultTile\@WideLogo 100310x150
140434x210
180558x270

 

See also

Quickstart: Creating a default tile using the Visual Studio manifest editor

Requirements

Namespace

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

 

 

Build date: 2/20/2013

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.