Office Settings & Configuration

Load Custom Ribbon Controls from a Word Startup Template

Natalie TaylorNatalie Taylor Nov 14, 2026 868 views

Question details

Load custom Word Ribbon controls from a macro-enabled startup template after moving to Microsoft 365.

Load Custom Ribbon Controls from a Word Startup Template
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.
Before you start

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.

Solution 1Recommended

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.

1
Create a macro-enabled template

In Word, select File > New, then use File > Save As and choose Word Macro-Enabled Template (*.dotm).

2
Add the Ribbon XML and callbacks

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.

3
Place the template in Startup

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.

4
Restart Word and check the controls

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.

Install the Ribbon customization as a Word startup template
Check macro trust settings: If the template loads but its buttons do not run, check File > Options > Trust Center > Trust Center Settings for macro and trusted-location settings. Follow your organization's security policies rather than enabling all macros.
Free Microsoft Office alternative

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.

Open and edit Microsoft Word DOC and DOCX filesUse a familiar Ribbon-style interface for document editingMove existing documents into a lightweight Office workflowCreate and edit documents for free
microsoft office alternative - wps office

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.