Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Defines the built-in Office ribbon tab on which your add-in command appears. If you want the add-in command to appear on a custom tab of your own, use the CustomTab element.
Add-in type: Task pane, Mail
Valid only in these VersionOverrides schemas:
- Taskpane 1.0
- Mail 1.0
- Mail 1.1
For more information, see Version overrides in the add-in only manifest.
Associated with these requirement sets:
- AddinCommands 1.1 when the parent <VersionOverrides> is type Taskpane 1.0.
- Mailbox 1.3 when the parent <VersionOverrides> is type Mail 1.0.
- Mailbox 1.5 when the parent <VersionOverrides> is type Mail 1.1.
Attributes
| Attribute | Required | Description |
|---|---|---|
| id | Yes | The ID of a built-in Office tab. |
id
This attribute specifies the ID of the built-in Office tab. A list of valid id values is at Find the IDs of built-in Office ribbon tabs.
Note
In Outlook, only one OfficeTab element with the TabDefault ID is supported. Defining more than one OfficeTab element can lead to unsupported and inconsistent ribbon rendering behavior.
Child elements
| Element | Required | Description |
|---|---|---|
| Group | Yes | Defines a group of controls. |
Group
A group of controls in a tab. A group can have up to six controls. You can add only one group per add-in to the default tab. See Group element.
OfficeTab example
<ExtensionPoint xsi:type="MessageReadCommandSurface">
<OfficeTab id="TabDefault">
<Group id="Contoso.msgreadTabMessage.group1">
<!-- Group Definition -->
</Group>
</OfficeTab>
</ExtensionPoint>
Office Add-ins