Troubleshoot a Missing Ribbon Separator in Office 2016 Custom XML
Question details
The user needs to determine why a separator in a custom Ribbon XML group is not visible in Office 2016.

- Product
- Microsoft Office 2016 Ribbon Custom UI
- Device & OS
- not provided
- Scenario
- A custom Ribbon group includes a separator alongside built-in controls such as Paste, Cut, Copy, and Find.
- Observed behavior
- The separator does not appear in the Office 2016 Ribbon.
Identify the Office 2016 application hosting the Ribbon and locate the complete Custom UI XML, including its namespace. Note how the customization is loaded, such as through a document or an add-in.
Validate the Custom UI XML and Test a Minimal Ribbon Group
Use this approach to isolate whether the separator definition, its placement, or the host application is responsible.
Ribbon control types and valid parent elements depend on the Custom UI schema and the Office host. A menu separator is not necessarily valid as a direct child of a Ribbon group.
Open the Custom UI XML in your XML editor and inspect the namespace on the customUI element. Use the corresponding Office Custom UI schema when validating the file.
Run your XML editor's schema validation and check whether the separator element is supported inside its parent group. If you need a separator inside a menu, check the schema for the menuSeparator control instead.
In a test copy of the customization, reduce the XML to one custom tab, one group, a simple button, and the separator definition. Load it in the same Office 2016 application and check the Ribbon.
If the host offers the setting, go to File > Options > Advanced > General and enable Show add-in user interface errors. Reload the customization and review any reported XML or control errors.
Add the Paste, Cut, Copy, and Find control references back one at a time, reloading the customization after each change to identify any interaction.

Ask the Microsoft Office Developer Community
Use this option if the minimal example still does not explain the missing separator.
Work With Office Documents in WPS Office
WPS Office is a free, lightweight alternative with a familiar interface and support for common Microsoft Office formats, making it easy to move everyday document work. It does not diagnose or fix Microsoft Office Ribbon XML.

Frequently Asked Questions
Can I place a menuSeparator directly inside a Ribbon group?
Do not assume it is supported there. Validate the XML against the schema matching the customUI namespace and check the allowed children of the group and menu elements.
How can I see Ribbon customization errors in Office 2016?
If available in your Office application, open File > Options > Advanced > General and enable Show add-in user interface errors. Reload the customization to check for messages.
Why should I test the separator without the built-in controls?
A minimal group helps distinguish a separator placement or schema issue from an interaction with other control definitions. Add the built-in controls back one at a time after the test.
What information should I include when asking for developer help?
Include the Office host and version, the complete minimal XML and namespace, how the customization is loaded, and any schema validation or UI error messages.




