Windows 8 app package manifest schema

This reference provides details for each element, attribute, and data type that defines the schema for the app package manifest for UWP apps. The schema definition file is AppxManifestSchema.xsd.

The following table lists all of the elements in this schema, sorted alphabetically by name.

Element Description
ActivatableClass (type: CT_InProcessActivatableClass)

Declares a runtime class associated with the extensibility point.

ActivatableClass (type: CT_OutOfProcessActivatableClass)

Declares a runtime class associated with the extensibility point.

ActivatableClassAttribute

Defines an attribute of the class that is stored in the Windows Runtime property store.

Application

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

ApplicationContentUriRules

Specifies which pages in the web context have access to the system's geolocation devices (if the app has permission to access this capability) and access to the clipboard.

Applications

Represents one or more apps that comprise the package.

Arguments

Specifies the list of comma-separated arguments to pass to the executable.

AutoPlayContent

Declares an app extensibility point of type windows.autoPlayContent. The app provides the specified AutoPlay content actions.

AutoPlayDevice

Declares an app extensibility point of type windows.autoPlayDevice. The app provides the specified AutoPlay device actions.

BackgroundTasks

Defines an app extensibility point of type windows.backgroundTasks. Background tasks run in a dedicated background host; that is, without a UI.

Capabilities

Declares the access to protected user resources that the package requires.

Capability

Declares a capability required by a package.

Certificate

A certificate for use with the package and placed in the system certificate stores.

Certificates

Declares a package extensibility point of type windows.certificates. The app requires one or more certificates from the specified certificate stores.

DataFormat

Specifies a data package format such as text or HTML format that the app can share. It is unique per application in the package and is case sensitive.

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.

Dependencies

Declares other packages that a package depends on to complete its software.

Description

A friendly description that can be displayed to users.

DeviceCapability

Declares a device capability required by a package.

DisplayName

A friendly name that can be displayed to users.

EditFlags

Specifies the type of info the user sees when opening a file associated to the extensibility point.

Extension (in type: CT_ApplicationExtensions)

Declares an extensibility point for the app.

Extension (in type: CT_PackageExtensions)

Declares an extensibility point for the package.

Extensions (type: CT_ApplicationExtensions)

Defines one or more extensibility points for the app.

Extensions (type: CT_PackageExtensions)

Defines one or more extensibility points for the package.

FileOpenPicker

Declares an app extensibility point of type windows.fileOpenPicker. The app lets the user choose and open the specified types of files.

FileSavePicker

Declares an app extensibility point of type windows.fileSavePicker. The app lets the user choose the file name, extension, and storage location for the specified types of files.

FileType (in type: CT_FTASupportedFileTypes)

A supported file type specified as its file type extension.

FileType (type: ST_FileType)

A file type specified as its file type extension. It is unique per application in the package and is case sensitive.

FileTypeAssociation

Declares an app extensibility point of type windows.fileTypeAssociation. A file type association indicates that the app is registered to handle files of the specified types.

Framework

Indicates whether the package is a framework package; that is, a package that can be used by other packages. Its value is false by default. You should not specify a value for it unless you are creating a framework.

GameExplorer

Declares a package extensibility point of type windows.gameExplorer.

Identity

Defines a globally unique identifier for a package. A package identity is represented as a tuple of attributes of the package.

InProcessServer

Declares a package extensibility point of type windows.activatableClass.inProcessServer. The app uses a dynamic link library (DLL) that exposes one or more activatable classes.

InfoTip

Defines a string that provides additional info to the user about the file type.

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](element-splashscreen.md) and the app UI when a new session is launched for your app. The preferences can be changed during run time through the [AutoRotationPreferences](/uwp/api/Windows.Graphics.Display.DisplayProperties) property.

Instancing

Specifies whether the executable runs as a single instance or can run as multiple instances.

Interface

Declares an interface associated with the proxy.

LaunchAction (in type: CT_AutoPlayContent)

Describes an AutoPlay content action.

LaunchAction (in type: CT_AutoPlayDevice)

Describes an AutoPlay device action.

LockScreen

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

Logo

A path to a file that contains an image.

OSMaxVersionTested

This should be filled in by the developer with the highest version of Windows that the package was tested on. This field is required. Windows will not block installation of the package on versions of the OS higher than the value provided in this field. When an app is executed, Windows will compare this field to the actual OS version. If the value provided in this field is less than the current OS version, Windows may provide behavior compatible with the highest tested OS version for some or all APIs. If the value provided in this field is greater than or equal to the current OS version, Windows will not apply any compatibility changes to APIs.

OSMinVersion

The minimum version of the operating system that the package requires.

OutOfProcessServer

Declares a package extension point of type windows.activatableClass.outOfProcessServer. The app uses an executable (EXE) that exposes one or more activatable classes.

Package

Defines the root element of an app package manifest. The manifest describes the structure and capabilities of the software to the system.

PackageDependency

Declares a dependency on another package that is marked as a framework package.

Path (type: ST_Executable)

The path to the executable.

Path (type: ST_FileName)

The path to the DLL.

Prerequisites

Declares the minimum operating system and software requirements that must exist for the package to be applicable to the system.

Properties

Defines additional metadata about the package including attributes that describe how the package appears to users.

Note  You may get an error if the manifest elements DisplayName or Description contain characters disallowed by the Windows firewall; namely β€œ|” and β€œall”, due to which Windows fails to create the AppContainer profile for the package . Use this reference for [troubleshooting](/windows/win32/appxpkg/troubleshooting) if you get an error.
 
Protocol

Declares an app extensibility point of type windows.protocol. A URI association indicates that the app is registered to handle URIs with the specified scheme.

ProxyStub

Declares a package extensibility point of type windows.activatableClass.proxyStub. A proxy can be composed of one or more interfaces.

PublisherDisplayName

A friendly name for the publisher that can be displayed to users.

Resource

Declares a language for resources contained in the package.

Resources

Declares languages for the resources that the package contains. Every package must declare at least one language for resources.

Rotation

Specifies a single rotational orientation in which an app will display.

Rule

Specifies which pages in the web context have access to the system's geolocation devices (if the app has permission to access this capability) and access to the clipboard.

SelectionCriteria

Defines selection criteria for the certificates defined for the package.

ShareTarget

Declares an app extension point of type windows.shareTarget. The app can share the specified types of files.

SplashScreen

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

SupportedFileTypes (type: CT_CharmsSupportedFileTypes)

Defines the file types that the app can share.

SupportedFileTypes (type: CT_FTASupportedFileTypes)

Defines the file types associated with the app. They are unique per package and are case sensitive.

SupportsAnyFileType

Indicates whether all file types are supported for sharing.

Task

The background task associated with the app extensibility point.

TrustFlags

Indicates whether the certificates for the package are exclusive to the package.

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.