Export (0) Print
Expand All

How to: Specify the Office host applications your app supports (manifest schema v1.1)

apps for Office

Learn how to specify the set of Office host applications your app supports when using the version 1.1 app manifest.

Last modified: February 27, 2015

Applies to: Access app for SharePoint | Access apps for SharePoint | apps for Office | Excel | Outlook | PowerPoint | Project | Word

Learn more about supported hosts and other requirements.

The Hosts element is a new optional element added in the version 1.1 schema for app manifests. This element lets you specify the set of Office host applications your app supports. If the Hosts element isn't specified in the manifest, the app should run in all hosts that support the API requirement sets and/or methods specified in the Requirements element.

In a version 1.1 app manifest, the Hosts element is essentially a replacement for the Capabilities element from version 1.0. The Capabilities element is no longer valid in a version 1.1 app manifest.

Hosts element

Optional attributes

None

Required attributes

None

Child elements

Host

Host element

Optional attributes

None

Required attributes

Name (string value described in the table below)

You can specify the following values in the Name attribute of a Host element. Each value maps to the set of one or more Office host applications your app supports.

Name attribute values

Name

Office host applications

"Document"

Word, Word RT

"Database"

Access app for SharePoint

"Mailbox"

Outlook, Outlook RT, Outlook Web App, OWA for Devices

"Presentation"

PowerPoint, PowerPoint Online, PowerPoint RT

"Project"

Project

"Workbook"

Excel, Excel RT, Excel Online

This example specifies that the app should load in Excel, Excel RT, Excel Online, and Access app for SharePoint.

<Hosts> 
   <Host Name="Workbook" /> 
   <Host Name="Database" /> 
</Hosts>

To see use of the Hosts and Host elements in the context of an app manifest, see the Sample manifest v1.1 XML files section of the "Apps for Office XML manifest overview" topic.

NoteNote

Most Name attribute values specify a set of more than one host application, which may include support for hosts that run across desktop, web, tablet, and smartphone devices. However, you can't specify which of the applications in the set can be used to host your app.

For example, if you specify the "Mailbox" value, both Outlook and Outlook Web App can always be used to host your app. There is no support for making only Outlook or Outlook Web App the host. However, for mail apps, you can explicitly specify support for tablets or smartphones, which enables Outlook RT or OWA for Devices to become hosts as well.

Show:
© 2015 Microsoft