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