CustomTab element

On the ribbon, you specify which tab and group for their add-in commands. This can either be on the default tab (either Home, Message, or Meeting), or on a custom tab defined by the add-in.

On custom tabs, the add-in can create up to 10 groups. Each group is limited to 6 controls, regardless of which tab it appears on. Add-ins are limited to one custom tab.

The id attribute must be unique within the manifest.

Child elements

Element Required Description
Group Yes Defines a Group of commands.
Label Yes The label for the CustomTab or a Group.
Control Yes A collection of one or more Control objects.


Required. See Group element.

Label (Tab)

Required. The label of the custom tab. The resid attribute must be set to the value of the id attribute of a String element in the ShortStrings element in the Resources element.

CustomTab example

<ExtensionPoint xsi:type="MessageReadCommandSurface">
  <CustomTab id="TabCustom1">
    <Group id="msgreadCustomTab.grp1">
    <Label resid="customTabLabel1"/>