Permissions element (MailApp complexType)
Collapse the table of content
Expand the table of content

Permissions element (MailApp complexType) (app manifest schema v1.1)

Office Add-ins

Controls the subset of the API that may be available to this mail app at runtime; the developer should request permissions based on "least privilege".

Last modified: March 09, 2015

Note Note

The name "apps for Office" is changing to "Office Add-ins". During the transition, the documentation and the UI of some Office host applications and Visual Studio tools might still use the term "apps for Office".

Mail app

Element type



Schema file


<xs:element name="Permissions" minOccurs="1" maxOccurs="1">
        <xs:restriction base="xs:string">
            <xs:enumeration value="Restricted" />
            <xs:enumeration value="ReadItem" />
            <xs:enumeration value="ReadWriteMailbox" />

If the schema defines specific requirements, such as sequence, minOccurs, maxOccurs, and choice, see the definition section.

Parent elements


Child elements







Permission that applies to all mail apps, enables the ItemIs and ItemHasKnownEntity activation rules, enables use of the RoamingSettings object and a subset of the JavaScript API for Office.


Applies to the selected item, includes the Restricted permission, and enables the mail app to use all the well-known entities and regular expression activation rules, to read all properties and write custom properties.


Includes all of the ReadItem permission and also enables the mail app to use the makeEWSRequestAsync method to read and write all properties of any item in the user's mailbox.


Applies to the selected item and includes the ReadItem permission and enables the mail app to use all the well-known entities and regular expression activation rules, to read all properties, to write properties in compose forms, and to write custom properties.

  • A mail app should request the level of permission based on the APIs it uses. Because the end user or IT administrator has to explicitly grant the permission before installing an app, requesting higher permission than needed may affect the chance of installation. Requesting insufficient permission can result in the host application blocking the use of specific APIs in the app and generating errors at runtime.

© 2015 Microsoft