Quickstart: Creating a default tile using the Microsoft Visual Studio manifest editor (Windows Runtime apps)
This topic walks you through the steps needed to create a default tile—the tile displayed in the Start screen until the tile begins to receive notifications—by using the Microsoft Visual Studio manifest editor.
Objective: To create a new project in Visual Studio using an installed template, and then define a default tile and its image in the package manifest.
- A version of Visual Studio that supports at least Windows 8
- A logo image, or set of images, to display on the tile.
- A small version of that logo image, for use in search results, the Apps list, and other places in the UI.
- Optional: A wide version of the logo image file. For more information on when and when not to include a wide image, see Guidelines and checklist for tiles.
1. Create a new project.
- Open Visual Studio.
- Click New Project...
- Click Installed in the left panel, if it is not already expanded.
- Under Templates, expand the project language.
- Choose Store Apps.
- Choose the best option for your app: Windows Apps, Phone Apps, or Universal Apps (includes both Windows and Windows Phone).
- From the center pane in the New Project window, choose Blank App.
- Give your project a name at the bottom of the window.
- Click OK.
2. Open the manifest editor
- If the Solution Explorer is not shown, choose it from the View menu.
- Double-click package.appxmanifest. This opens the manifest editor window.
3. Supply the default tile details
Note This step does not cover every option available in the manifest editor, just those options pertinent to the default tile.
Select the Application tab if it isn't already selected.
Change the Display name if necessary. This is the name that the tile is listed by in the Apps list and is displayed on the tile.
Select the Visual Assets tab
Under Tile Images and Logos, default images are provided for all logos in the Windows Phone manifest and select logos in the Windows manifest:
- Square 150x150 Logo
- Square 30x30 Logo
- Store Logo
You should replace these images with your own. You have the option of supplying images for different visual scales, but you are not required to supply them all. If you only want to supply one image for each logo, supply the 180% scale for Windows and 240% scale for Windows Phone. Note that supplied images must be of the exact pixel dimensions specified in the manifest editor.
Important For wide and large tile sizes, you must supply wide and large logo images to allow the user to resize your app's tile to those sizes. Without those logo images, your app tile will be restricted to medium and small sizes.
Enter a short name for the app. This can be used on the tile in place of the display name. This name should be 13 characters or less. If the name is too long, it will be truncated. You can elect to show the logo, the short name, or neither in tile updates.
Choose the tile sizes on which the short name can be shown.
Windows only: Choose whether the name's text should use a light or dark font, making your choice based on the tile's background color.
Windows only: Choose a default size for your tile. When the user pins your app to the Start screen, this is the size it appears.
Either accept the default background color or provide your own as a W3DC color string (for example, "#FFFFFF"). This background color is used to colorize other aspects of your app: the button color in any app-owned dialog boxes and the App Description page in the Windows Store. Note Windows Phone: Set the background color to "transparent" to use the system's accent color.
Summary and next steps
In this Quickstart, you created the definition of a default tile in a package manifest.
After the app is installed, you can begin updating the tile with information that is relevant to the user. To learn about designing and sending a tile notification, see Quickstart: Sending a tile update.