Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
desktop7:Extension
Declares an extensibility point for the app.
Element hierarchy
<Package>
└─ <Extensions>
└─ <desktop7:Extension>
└─ <Applications>
└─ <Application>
└─ <Extensions>
└─ <desktop7:Extension>
Syntax
<desktop7:Extension
Category = 'A required string that can have one of the following values: "windows.approvedShellExtension", "windows.controlPanelItem", "windows.service", "windows.mailProvider", "windows.shortcut", "windows.applicationRegistration", "windows.desktopAppMigration", "windows.systemFileAssociation", "windows.shadowCopyExcludeFiles", or "windows.errorReporting".'
desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".'
Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
RuntimeType = 'An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
StartPage = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer", or "mediumIL".'
uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
uap10:HostId = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
uap11:Id = 'An optional string between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
uap11:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
uap11:SupportsMultipleInstances = 'An optional boolean value.'
uap11:ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
CompatMode = 'An optional string that can have one of the following values: "classic", or "modern".'
Scope = 'An optional string that can have one of the following values: "machine", or "user".' >
<!-- Child elements -->
desktop7:ApprovedShellExtension?
desktop7:ControlPanelItem?
desktop7:ShadowCopyExcludeFiles?
desktop7:Service?
desktop7:Shortcut?
desktop7:ApplicationRegistration?
desktop7:MailProvider?
desktop7:DesktopAppMigration?
desktop7:ErrorReporting?
desktop7:SystemFileAssociation?
</desktop7:Extension>
Key
? optional (zero or one)
Attributes
| Attribute | Description | Data type | Required | Default value |
|---|---|---|---|---|
| Category | The category of the extension. | A string that must be one of the following values: windows.approvedShellExtension, windows.controlPanelItem, windows.service, windows.mailProvider, windows.shortcut, windows.applicationRegistration, windows.desktopAppMigration, windows.systemFileAssociation, windows.shadowCopyExcludeFiles, windows.errorReporting (in Application); windows.shadowCopyExcludeFiles, windows.errorReporting (in Package). | Yes | |
| desktop11:AppLifecycleBehavior | An optional string that can have one of the following values: systemManaged, unmanaged. | No | ||
| Executable | The default launch executable. | An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. | No | |
| EntryPoint | The activatable class ID. | An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character. | No | |
| RuntimeType | The runtime provider. Typically used when there are mixed frameworks in an app. | An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, , |, ?, or *. | No | |
| StartPage | The web page that handles the extensibility point. | An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. | No | |
| ResourceGroup | A tag that you can use to group extension activations together for resource management purposes (for example, CPU and memory). | An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. | No | |
| uap10:TrustLevel | Specifies the trust level of the extension. | An optional string that can have one of the following values: appContainer, mediumIL. | No | |
| uap10:RuntimeBehavior | Specifies the run time behavior of the extension. | An optional string that can have one of the following values: windowsApp, packagedClassicApp, win32App. | No | |
| uap10:HostId | Specifies the ID of the host runtime for the extension. | An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. | No | |
| uap10:Parameters | Contains command line parameters to pass to the extension. Only supported for desktop apps that have package identity. | An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. | No | |
| uap11:Id | An identifier for the extension. The ID must be unique for all extensions in a package. | An optional string between 1 and 255 characters in length with a non-whitespace character at its beginning and end. | No | |
| uap11:Subsystem | The subsystem targeted by the extension. | An optional string that can have one of the following values: console, windows. | No | |
| uap11:SupportsMultipleInstances | Specifies whether instances should run in different processes. The default value is false. | An optional boolean value. | No | |
| uap11:ResourceGroup | A tag that you can use to group extension activations together for resource management purposes (for example, CPU and memory). The value you can set ResourceGroup is free-form and flexible. See Application@ResourceGroup. | An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. | No | |
| uap11:CurrentDirectoryPath | Specifies the initial directory when the application process is launched. This attribute supports macros. For more info, see Macros in the package manifest schema. | An optional string that cannot contain these characters: <, >, |, ?, or *. | No | |
| uap11:Parameters | The subsystem targeted by the extension. This attribute supports macros. For more info, see Macros in the package manifest schema. | An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. | No | |
| CompatMode | Specifies whether this extension's information is registered with Windows in classic ways (e.g. unpackaged apps register types with COM via the registry) or in new more scoped ways. The default value is "modern". CompatMode="classic" requires the Microsoft.classicAppCompat_8wekyb3d8bbwe capability. | An optional string that can have one of the following values: classic, modern. | No | |
| Scope | Specifies whether the registrations are only visible to other applications running as a user who has this package registered (user), or whether they are visible to all users and services on the machine (machine). The default value is "user". Scope="machine" requires the Microsoft.classicAppCompatElevated_8wekyb3d8bbwe capability. | An optional string that can have one of the following values: machine, user. | No |
Child elements
| Child element | Description |
|---|---|
| desktop7:ApprovedShellExtension | Specifies that a shell extension should be added to the approved shell extensions list when installed. |
| desktop7:ControlPanelItem | Registers an extension as a control panel item. |
| desktop7:ShadowCopyExcludeFiles | Specifies a set of files to be excluded by the Volume Shadow Copy Service (VSS). |
| desktop7:Service | Specifies a service that is installed and registered along with the app. These services can be configured to run under either the Local Service, Network Service or Local System account. |
| desktop7:Shortcut | Creates a shortcut to a file. |
| desktop7:ApplicationRegistration | Registers an application in the registry, replacing the need to register the application in the system PATH variable. |
| desktop7:MailProvider | Registers a dll as a mail provider. |
| desktop7:DesktopAppMigration | Specifies a set of app migration entries for tiles and pins. |
| desktop7:ErrorReporting | Specifies a set of runtime exception helper modules. |
| desktop7:SystemFileAssociation | Registers system file associations for an app. |
Parent elements
| Parent element | Description |
|---|---|
| Extensions (in Package) | Defines one or more extensibility points for the package. |
| Extensions (in Application) | Defines one or more extensibility points for the app. |
Requirements
| Item | Value |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/desktop/windows10/7 |
| desktop11 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/11 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| uap11 | http://schemas.microsoft.com/appx/manifest/uap/windows10/11 |
| Minimum OS Version | Windows 10 (Build 19645) |
Remarks
Examples
Feedback
Was this page helpful?