Diagnostics

Run health checks on your add-ins and Office configuration to catch problems early

Overview

The Diagnostics page runs automated health checks on your add-ins and Office configuration, surfacing inconsistencies that commonly cause add-ins to silently fail to load.

Running diagnostics

Click Run Diagnostics to start a full scan. Deck checks for issues such as:

• Orphaned registrations - add-in registry keys that point to a DLL that no longer exists.
• Missing files - VSTO add-ins whose manifest or assembly can't be found.
• Duplicate registrations - the same add-in (ProgID) registered in more than one place.
• Load-behavior mismatches - add-ins whose current LoadBehavior doesn't match the active profile's intent.
• Policy references to missing apps - an AllowedOfficeApps entry for an Office application that isn't installed.

Understanding results

Each result is classified:

• Healthy - no issue detected.
• Warning - a potential issue that may not cause immediate problems.
• Error - a problem that is likely causing failures and should be addressed.

Resolving issues

Click any result for details and suggested remediation. Many issues are resolved by re-scanning (Settings → Clear data) or by activating the Original profile to reset add-in state. For registry-level problems, see Registry Details. For anything you can't resolve, submit a support request with the diagnostic output - see Collecting diagnostic logs.