<CommandUIDefinition> (RibbonDiffXml)


Updated: November 29, 2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Specifies the visible Ribbon elements to be included within a CustomAction element.

<CommandUIDefinition >
 <Button /> |
 <CheckBox /> |
 <ComboBox /> |
 <ColorPicker /> |
 <ContextualGroup /> |
 <Controls /> |
 <DropDown /> |
 <FlyoutAnchor /> |
 <Gallery /> |
 <GalleryButton /> |
 <GroupTemplate /> |
 <Group /> |
 <Groups /> |
 <InsertTable /> |
 <Label /> |
 <MRUSplitButton /> |
 <MaxSize /> |
 <Menu /> |
 <MenuSection /> |
 <Scale /> |
 <Scaling /> |
 <Spinner /> |
 <SplitButton /> |
 <Tab /> |
 <TextBox /> |
 <ToggleButton />

Attributes and Elements

The following table lists the attributes, child elements, and parent elements.


This element has no attributes.

Child Elements



<Button> (RibbonDiffXml)

Specifies a simple button used to perform an action.

<CheckBox> (RibbonDiffXml)

Specifies a check box used to select an option.

<ComboBox> (RibbonDiffXml)

Deprecated: Specified a list used to select a value by clicking or typing.

<ColorPicker> (RibbonDiffXml)

Deprecated: Specified a grid used to select a color or style.

<ContextualGroup> (RibbonDiffXml)

Contains a collection of tabs to be displayed within a specific context.

<Controls> (RibbonDiffXml)

Contains a collection of controls.

<DropDown> (RibbonDiffXml)

Deprecated: Specified a list used to select a value by clicking.

<FlyoutAnchor> (RibbonDiffXml)

Specifies a button with a down arrow used to open a menu.

<Gallery> (RibbonDiffXml)

Deprecated: Specified a control that displays a collection of related controls in the Ribbon. If there are too many items in the gallery, an expand arrow is provided to display the rest of the collection in a pane.

<GalleryButton> (RibbonDiffXml)

Deprecated: Specified a button control within a gallery element.

<GroupTemplate> (RibbonDiffXml)

Specifies a collection of layout definitions that a group can use when the ribbon width changes.

<Group> (RibbonDiffXml)

Specifies a group of controls within a tab that share a common layout template.

<Groups> (RibbonDiffXml)

Contains a collection of Group elements.

<InsertTable> (RibbonDiffXml)

Deprecated: Specified a 10 by 10 grid used to specify the dimensions of a table.

<Label> (RibbonDiffXml)

Specifies a line of text used to provide information.

<MRUSplitButton> (RibbonDiffXml)

Deprecated: Specified a split button control that displays Most Recently Used items.

<MaxSize> (RibbonDiffXml)

Defines the largest layout possible for a group.

<Menu> (RibbonDiffXml)

Specifies a container used to show pop-up menus.

<MenuSection> (RibbonDiffXml)

Specifies a section used to divide a menu. A menu section can have a title and contain controls.

<Scale> (RibbonDiffXml)

Specifies one of the possible layouts that may be used by a group when the maximum size layout cannot be displayed.

<Scaling> (RibbonDiffXml)

Contains a collection of elements used to define how ribbon groups are presented when the horizontal space available changes.

<Spinner> (RibbonDiffXml)

Specifies a control used to insert a value by typing or using the arrow keys to cycle through the values.

<SplitButton> (RibbonDiffXml)

Specifies a control used as both a button and a menu.

<Tab> (RibbonDiffXml)

Specifies a tab in the ribbon.

<TextBox> (RibbonDiffXml)

Deprecated: Specified a control used to enter text.

<ToggleButton> (RibbonDiffXml)

Specifies a button used to toggle between an on and off state.

Parent Elements



<CustomAction> (RibbonDiffXml)

Defines an action to add or replace items in the ribbon.

Element Information



Schema Name


Validation File


Can be Empty


Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright

Community Additions