Load Custom Ribbon Controls from a Word Startup Template
Question details
Load custom Word Ribbon controls from a macro-enabled startup template after moving to Microsoft 365.

- Product
- Microsoft Word for Microsoft 365
- Device & OS
- not provided
- Scenario
- Custom Ribbon XML and buttons previously stored in Normal.dotm need to be available whenever Word starts.
- Observed behavior
- The custom Ribbon controls may not load correctly from Normal.dotm after the Office upgrade.
Identify the Ribbon XML and any VBA callback macros used by the controls in Normal.dotm. In Word, check File > Options > Advanced > File Locations to confirm the configured Startup folder.
Install the Ribbon customization as a Word startup template
Use a macro-enabled template in Word's Startup folder to load custom controls as a global add-in.
A startup template can provide Ribbon controls across Word documents. The template must contain both the Ribbon XML and the VBA callbacks referenced by that XML.
In Word, select File > New, then use File > Save As and choose Word Macro-Enabled Template (*.dotm).
Use an Office Ribbon XML editor to add the custom Ribbon XML to the .dotm file. In Word, open the VBA editor with Alt+F11 and add the macros referenced by the Ribbon XML to the template.
Close Word and move the .dotm file into the Startup folder shown under File > Options > Advanced > File Locations. On Windows, the default is typically C:\Users\[UserName]\AppData\Roaming\Microsoft\Word\STARTUP.
Open Word again and look for the custom tab or buttons. To check whether the template is loaded, open File > Options > Add-ins and select Word Add-ins from the Manage list.

Edit Word Documents with WPS Office
WPS Office is a free, lightweight alternative with a familiar interface for opening and editing Word documents. Its support for common Office formats makes it easy to bring existing documents into your workflow, though it does not fix Word's startup template or guarantee compatibility with custom Ribbon XML and VBA callbacks.

Frequently Asked Questions
Where is Word's Startup folder?
In Word, go to File > Options > Advanced > File Locations and check the Startup entry. On Windows, the default is typically C:\Users\[UserName]\AppData\Roaming\Microsoft\Word\STARTUP.
Why do my Ribbon buttons appear but not run?
Check that the .dotm template contains the VBA callbacks named in the Ribbon XML. Also review File > Options > Trust Center > Trust Center Settings for any macro restrictions.
How can I tell whether Word loaded my startup template?
Go to File > Options > Add-ins, choose Word Add-ins in the Manage list, and select Go. Look for your template in the global templates and add-ins list.
Can I add custom Ribbon XML using Word's standard Ribbon settings?
Word's File > Options > Customize Ribbon controls standard Ribbon customization, but adding custom Ribbon XML to a template generally requires an Office Ribbon XML editor.




