Edit

DefaultTile (feature extensions schema for Windows 8.1)

  • Article

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

<VisualElements>
<DefaultTile>

Syntax

<DefaultTile Wide310x150Logo?   = 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.
             Square310x310Logo? = 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.
             Square70x70Logo?   = 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.
             ShortName?         = A string between 1 and 40 characters in length.
             DefaultSize?       = "square150x150Logo" | "wide310x150Logo" >

  <!-- Child elements -->
  ( TileUpdate?
  & ShowNameOnTiles?
  )

</DefaultTile>

Key

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

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
DefaultSize

The default size of the logo image. This value is ignored on Windows Phone 8.1.

This attribute can have one of the following values:

  • square150x150Logo
  • wide310x150Logo
 No
ShortName

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

Note  As of Windows 8.1, this property is ignored and the display name declared in the manifest is used in its place.
 
A string between 1 and 40 characters in length. No
Square310x310Logo

The 310x310 square version of the logo image.

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. No
Square70x70Logo

The 70x70 square version of the logo image.

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. No
Wide310x150Logo

The 310x150 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 can't 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 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. No

 

Child Elements

Child Element Description
ShowNameOnTiles

Describes whether Windows overlays the app’s name on top of the tile images that are shown on the Start screen.
TileUpdate

Describes how the app tile receives update notifications.

 

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

Wide310x150Logo, Square310x310Logo, and Square70x70Logo 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 localized images to match different UI languages. This feature also allows you to localize the ShortName attribute. For more info, see the Globalization topic.

Requirements

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