OfficeTab element
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 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.
Child elements
Element | Required | Description |
---|---|---|
Group | Yes | Defines a group of commands. You can add only one group per add-in to the default tab. |
The following are valid tab id
values by application. Values in bold are supported in both desktop and online (for example, Word 2016 or later on Windows and Word on the web).
Outlook
- TabDefault (either Home, Message, or Meeting)
Word
- TabHome
- TabInsert
- TabWordDesign
- TabPageLayoutWord
- TabReferences
- TabMailings
- TabReviewWord
- TabView
- TabDeveloper
- TabAddIns
- TabBlogPost
- TabBlogInsert
- TabPrintPreview
- TabOutlining
- TabConflicts
- TabBackgroundRemoval
- TabBroadcastPresentation
Excel
- TabHome
- TabInsert
- TabPageLayoutExcel
- TabFormulas
- TabData
- TabReview
- TabView
- TabDeveloper
- TabAddIns
- TabPrintPreview
- TabBackgroundRemoval
PowerPoint
- TabHome
- TabInsert
- TabDesign
- TabTransitions
- TabAnimations
- TabSlideShow
- TabReview
- TabView
- TabDeveloper
- TabAddIns
- TabPrintPreview
- TabMerge
- TabGrayscale
- TabBlackAndWhite
- TabBroadcastPresentation
- TabSlideMaster
- TabHandoutMaster
- TabNotesMaster
- TabBackgroundRemoval
- TabSlideMasterHome
OneNote
- TabHome
- TabInsert
- TabView
- TabDeveloper
- TabAddIns
Group
A group of UI extension points in a tab. A group can have up to six controls. The id attribute is required and each id must be unique among all groups in the manifest. The id is a string with a maximum of 125 characters. 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
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for