text (Tile schema)

Specifies text used in the tile template.

Element hierarchy



<text id    = integer
      lang? = string />


?   optional (zero or one)

Attributes and Elements


Attribute Description Data type Required Default value

The text element in the tile template that this text is intended for. If a template has only one text element, then this value is 1. The number of available text positions is based on the template definition.

integer Yes None

The target locale of the XML payload, specified as a BCP-47 language tags such as "en-US" or "fr-FR". The locale specified here overrides any other specified locale, such as that in binding or visual. If this value is a literal string, this attribute defaults to the user's UI language. If this value is a string reference, this attribute defaults to the locale chosen by Windows Runtime in resolving the string.

string No None


Child Elements


Parent Elements

Parent Element Description

Specifies the tile template. Every notification should include one binding element for each supported tile size.



The body of the text element can be expressed in two ways:

  • As a literal string; for instance, <text id="1">Hello world!</text>.
  • As a string reference, using the "ms-resource" prefix; for instance, <text id="1"> ms-resource:hello</text>. When using the "ms-resource" prefix, the string identifier is referenced in the app's Resources.resjson (Windows app using JavaScript) or Resources.resw file (C#/C++).

For more information, see Globalizing your tile: localization, scaling, and accessibility.


Namespace http://schemas.microsoft.com/notifications/2012/tile.xsd