Distribute Microsoft Word Ribbon Customizations Without Replacing the Quick Access Toolbar
Question details
The user wants to distribute a custom Word Ribbon tab without replacing users' Quick Access Toolbar settings and wants to know whether third-party add-in controls can be duplicated.

- Product
- Microsoft Word
- Device & OS
- not provided
- Scenario
- Deploy a custom Ribbon tab that may include functionality from a COM add-in such as Adobe Acrobat PDFMaker.
- Observed behavior
- Importing a Word customization file may replace existing Ribbon and Quick Access Toolbar customizations. XML copied from a third-party add-in control does not reproduce its automation in a global template.
Identify whether you are distributing a global template or an exported Word customization file, and test the deployment with an existing Quick Access Toolbar customization. If you need a third-party command, check with its vendor for a supported automation interface.
Use a global template to add your own Ribbon tab
Use a global template when you need to distribute your own Ribbon controls without importing a file that replaces users' existing customizations.
Custom UI XML can define a button and connect it to a callback in your template, but it cannot clone a third-party COM add-in's control or its automation. A callback can invoke the add-in only if the vendor provides a supported way to do so.
In Word, create a macro-enabled template and save it as a .dotm file using File > Save As.
Use a Custom UI editor to add a custom tab and button to the template. Set the button's onAction attribute to the name of your own callback procedure.
Add the callback procedure to the template's VBA project. If it must invoke a third-party add-in, use only an automation method documented or supplied by that add-in's vendor.
In Word, open File > Options > Add-ins, choose Templates in the Manage list, and select Go. Add the template, then check that the tab works and the existing Quick Access Toolbar remains intact.

Make an exported Word customization import optional
Use this approach when distributing a Word customization file is acceptable and users can choose whether to replace their existing settings.
Edit Word Documents with WPS Office
WPS Office is a free, lightweight alternative with a familiar interface for working with Word documents. Its support for common Office formats makes it easier to move everyday document work, although it does not fix Word's Ribbon deployment or third-party COM add-in integration.

Frequently Asked Questions
Can Custom UI XML copy an Acrobat PDFMaker button and its behavior?
No. XML can create a button with a similar label or image, but it does not clone the add-in's automation. Contact Adobe for a supported integration method that your own callback can invoke.
Will importing a customization file preserve my Quick Access Toolbar?
Do not assume it will. Importing through File > Options > Customize Ribbon > Import/Export may replace existing Ribbon and Quick Access Toolbar customizations. Export the current settings first and review the confirmation.
How can I restore my previous Ribbon and toolbar settings?
If you exported them before deployment, open File > Options > Customize Ribbon > Import/Export and import the saved customization file. This restores the exported set rather than merging individual controls.
Can a global template add a Ribbon tab without an exported customization import?
Yes. A global template can contain Custom UI XML for its own tab and controls. Load it through File > Options > Add-ins, select Templates under Manage, and choose Go; test it with existing user customizations.




