Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

uap3:AppExtension

Declares an app extensibility point of type windows.appExtension. This element indicates which categories of extensions the app intends to consume and/or host.

Element hierarchy

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <uap3:Extension>
               └─ <uap3:AppExtension>

Syntax

<uap3:AppExtension
 Name = 'A required string with a value between 2 and 65519 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
 Id = 'A required string with a value between 2 and 39 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
 PublicFolder = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
 DisplayName = 'A required string between 1 and 256 characters in length. This string is localizable.'
 Description = 'An optional string between 1 and 2048 characters in length.' >

 <!-- Child elements -->
 uap3:Properties?

</uap3:AppExtension>

Key

? optional (zero or one)

Attributes

Attribute Description Data type Required Default value
Name The type of extension that the app intends to consume and/or host. A string with a value between 2 and 65519 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only. Yes
Id The entry point by which the host app accesses the extension category instance, if there are multiple entry points. A string with a value between 2 and 39 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only. Yes
PublicFolder The folder that the instance declares as the location where a host can have read access to files through a broker. An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. No
DisplayName A friendly name for the app extension that can be displayed to users. A string between 1 and 256 characters in length. This string is localizable. Yes
Description The description of the app An optional string between 1 and 2048 characters in length. No

Child elements

Child element Description
uap3:Properties Contains opaque XML that represents custom, extension-specific information that is simply stored and not read by the operating system. The information is only read by the host app.

Parent elements

Parent element Description
uap3:Extension Declares an extensibility point for the app.

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/3
Minimum OS Version Windows 10 version 1607 (Build 14393)

Remarks

Examples

The following example indicates that the app hosts or consumes the low-performance browser extension

<Package
 xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3" 
 IgnorableNamespaces="... uap3">
 <Applications>
 <Application>
 <Extensions>
 <uap3:Extension 
 Category="windows.appExtension"> 
 <uap3:AppExtension
 Name="com.microsoft.browser.ext"
 Id="Extension.Low.Performance"
 PublicFolder="public\lowperf"
 DisplayName="Low Performance Extension"/> 
 </uap3:Extension> 
 </Extensions>
 </Application>
 </Applications>
</Package>

Feedback

Was this page helpful?

Additional resources