logo
search
VBA & Macro Problems

How to Fix Microsoft Word VBA Add-Ins That Stop Working

Rana GarciaRana Garcia Oct 10, 2026 869 views

Question details

The user needs to restore the functionality of third-party VBA add-ins in Microsoft Word, where the add-in tabs appear in the ribbon but the buttons remain unresponsive or unavailable.

How to Fix Microsoft Word VBA Add-Ins That Stop Working
Product
Microsoft Word
Device & OS
Windows
Scenario
Trying to use third-party VBA macro add-ins in Microsoft Word after they unexpectedly stopped functioning.
Observed behavior
The VBA add-in tabs are visible on the Word ribbon, but their corresponding buttons are unavailable or cannot be clicked.
Before you start

Ensure that Microsoft Word is completely closed before troubleshooting, and verify you have access to the original add-in template files (.dotm) provided by the developer.

Solution 1Recommended

Move the Add-in Template to the Word STARTUP Folder

Placing the add-in template in the correct startup directory ensures the VBA macros load automatically and correctly when Word launches.

Often, VBA add-ins fail to execute because Word loses the correct path to the template file. Moving the template directly into Word's dedicated STARTUP folder forces the application to load the macros upon launch.

1
Close Microsoft Word

Make sure Microsoft Word is completely closed. You can verify this by checking the Task Manager to ensure no Word background processes are running.

2
Open File Explorer

Press Windows Key + E to open a new File Explorer window.

3
Navigate to the STARTUP Folder

Click on the address bar at the top of File Explorer, type %appdata%\Microsoft\Word\STARTUP, and press Enter.

4
Copy the Template File

Locate your third-party VBA add-in template (usually a .dot or .dotm file) and paste it into this STARTUP folder.

5
Reopen Word and Test

Launch Microsoft Word again and navigate to the add-in tab to verify if the buttons are now active and functioning.

Move the Add-in Template to the Word STARTUP Folder
Add-ins Loaded successfully: Once placed in the STARTUP folder, the add-in will be globally available across all your Word documents.
Free Microsoft Office alternative

Try WPS Office for Seamless Document Editing

If you are continuously running into compatibility issues or failing add-ins with Microsoft Word, consider switching to WPS Office. It provides a lightweight, highly compatible alternative with a familiar interface, ensuring your document workflows remain uninterrupted.

  1. 1. Download the Software: Visit the official WPS website to download the free installation package for your operating system.
  2. 2. Install WPS Office: Run the installer and follow the simple on-screen instructions to set up WPS Office on your device.
  3. 3. Open Your Documents: Launch WPS Writer and seamlessly open your existing Word documents to continue your work instantly.
High compatibility with Microsoft Word (.docx, .doc, .dotm) formatsFamiliar ribbon interface for a zero-learning-curve transitionLightweight installation and incredibly fast startup timesRobust alternative for daily document editing without complex configuration errors
QA img-9

Frequently Asked Questions

Why are my Word VBA add-in buttons grayed out?

This typically happens when the underlying template file (.dotm) is missing from the Word Startup folder, or when a recent security update in the Trust Center disables macros from running.

Where is the Microsoft Word STARTUP folder located?

On Windows, the default location is %appdata%\Microsoft\Word\STARTUP. You can easily access this by pasting the path directly into your File Explorer address bar.

Can Windows updates cause Word add-ins to stop working?

Yes, Microsoft Office or Windows updates can sometimes modify security policies or introduce background changes that block third-party VBA code. In these cases, the developer may need to issue an update.

What is a .dotm file?

A .dotm file is a Microsoft Word macro-enabled template file. It is commonly used by developers to package and distribute custom VBA add-ins and macros.