Excel Macro Not Working? A 12-Point Diagnostic Checklist With Fixes

Troubleshooting · 16 September 2026 · ~14 min read

Excel macro not working? Usually the file is blocked because it came from the internet, macros are disabled in the Trust Center, the workbook was saved as .xlsx, a button points to a renamed macro, or the code has a compile error or missing reference. This checklist takes each in order, quickest first.

Sources last checked: 16 September 2026. Steps target Excel for Microsoft 365 on Windows; Excel for the web can't create, run or edit VBA macros (for browser-first teams, see VBA vs Office Scripts vs Python). Just need to switch macros on? See how to enable macros in Excel safely. New to macros? Start with what a macro in Excel is.

Why is my Excel macro not working? Symptoms and first fixes

Start with what you see: the message bar under the ribbon, the error text, or nothing at all.

1. Macros blocked in a downloaded or emailed file (Mark of the Web)

Symptom: a red SECURITY RISK bar says macros are blocked because the file's source is untrusted, with no Enable Content button.

Cause: Windows marks downloads and email attachments as coming from the internet. Since Current Channel Version 2206 (rolled out from 27 July 2022), Office for Windows blocks macros in those files by default, whatever your macro setting.

Fix, only for a file you trust and expected:

• Close it, right-click it in File Explorer, choose Properties, tick Unblock and reopen.
• For regular exports, use a dedicated Trusted Location, not your Downloads folder. For OneDrive or SharePoint, Open in Desktop App avoids the mark.
• Traps: network-share files opened by IP address stay blocked unless IT trusts the location, and signing an .xlam add-in doesn't get it past the mark.

2. Trust Center macro settings are disabling it

Symptom: a yellow SECURITY WARNING bar, or no bar and no result, or "The macros in this project are disabled" in the VBA editor.

Cause: File > Options > Trust Center > Trust Center Settings > Macro Settings. Disable VBA macros without notification silences everything; Disable VBA macros except digitally signed macros blocks unsigned code. The setting applies only to the app you change it in.

Fix: choose the default, Disable VBA macros with notification, reopen the file and click Enable Content. Avoid "Enable VBA macros"; if settings are policy-managed, ask IT.

3. The workbook is saved as .xlsx (a macro-free file type)

Symptom: yesterday's macros are gone and every button fails.

Cause: .xlsx cannot store VBA code. Excel warns on save; clicking Yes discards the code.

Fix: Save As Excel Macro-Enabled Workbook (*.xlsm) or .xlsb (.xlam for add-ins). Renaming the extension won't recover the code; use the last .xlsm, a backup or OneDrive version history. Tip for ERP exports: keep the macro in its own .xlsm and point it at the CSV, so the export never has to hold code (more in Excel automation for finance teams).

4. A button runs a renamed, deleted or missing macro

Symptom: "Cannot run the macro '...'. The macro may not be available in this workbook or all macros may be disabled."

Cause: a button stores the macro name as text, so renaming or deleting the Sub breaks it. Copied sheets often keep a link such as 'Old Pack.xlsm'!PostJournals. Disabled macros give the same message, so rule out checks 1 and 2.

Fix: right-click the button, choose Assign Macro (Microsoft's steps) and pick the macro from this workbook. Only public Subs with no arguments appear in the list; Private Subs and Subs with arguments won't show up. ActiveX buttons instead run a Click procedure in the sheet module named after the button, such as CommandButton1_Click.

5. Personal.xlsb macros have disappeared

Symptom: your Personal Macro Workbook macros are missing from every file.

Cause: files in the XLStart folder open automatically whenever Excel starts. If Personal.xlsb was moved, renamed or disabled after a crash, it doesn't load.

Fix: go to File > Options > Add-ins, set Manage to Disabled Items, click Go, enable Personal.xlsb if listed, and restart. Then press Ctrl+G in the VBA editor and type ?Application.StartupPath to see the startup folder Excel uses. PERSONAL.XLSB normally lives there (or in an alternate startup folder set under File > Options > Advanced).

6. Event macros don't fire (Application.EnableEvents is off)

Symptom: Worksheet_Change or Workbook_Open code stops, while buttons still work.

Cause: code often sets Application.EnableEvents to False so its own edits don't retrigger it. If it fails before restoring it, events stay off Excel-wide until something sets it back to True or you restart Excel. The other cause is placement: sheet events belong in that sheet's module and workbook events in ThisWorkbook.

Fix: type Application.EnableEvents = True in the Immediate window and press Enter. Then make the handler restore events even when it fails. This sheet-module code timestamps column C when B2:B500 changes; adjust the range. If the module already has Option Explicit or a Worksheet_Change, merge these lines into it, because two procedures with the same name cause "Ambiguous name detected".

Option Explicit

Private Sub Worksheet_Change(ByVal Target As Range)
    Dim changed As Range
    Dim cell As Range

    Set changed = Intersect(Target, Me.Range("B2:B500"))
    If changed Is Nothing Then Exit Sub

    On Error GoTo CleanUp
    Application.EnableEvents = False

    For Each cell In changed.Cells
        cell.Offset(0, 1).Value = Now
    Next cell

CleanUp:
    Application.EnableEvents = True
    If Err.Number <> 0 Then
        MsgBox "Timestamp not written: " & Err.Description, vbExclamation
    End If
End Sub

7. A compile error anywhere in the VBA project

Symptom: "Compile error:" appears before anything runs, often after an edit to a different module.

Cause: with Compile On Demand ticked, VBA compiles code as needed, so an error in a rarely used module stays hidden until something calls into it.

Fix: in the VBA editor choose Debug > Compile VBAProject, which compiles your project and stops at the first error. Repeat until it greys out. Tick Tools > Options > Require Variable Declaration so new modules get Option Explicit.

Pasted AI-chat code often causes these; see whether ChatGPT can write reliable VBA.

8. Missing references ("Can't find project or library")

Symptom: the error highlights a built-in function such as Left or Date, and the file works on your PC but not a colleague's.

Cause: the project references a library (Outlook, ADO, a vendor DLL) that is missing or a different version on this PC. Microsoft says you can't run your code until every missing reference is resolved.

Fix: open Tools > References, and untick or replace anything marked MISSING:. For shared workbooks, late binding (As Object with CreateObject) avoids version-specific references.

9. Old Declare statements on 64-bit Excel (PtrSafe)

Symptom: "The code in this project must be updated for use on 64-bit systems", or odd results after someone added PtrSafe.

Cause: 64-bit is the default install since Office 2019 and Microsoft 365. Per Microsoft's 64-bit VBA overview, every Declare needs PtrSafe, and pointers and handles need LongPtr; PtrSafe alone doesn't stop truncated values.

Fix: update the Declare and the variables that hold its results. Adapted from Microsoft's GetActiveWindow example, this works in 32-bit and 64-bit Excel 2010 or later:

Option Explicit

' Old: Declare Function GetActiveWindow Lib "user32" () As Long
Private Declare PtrSafe Function GetActiveWindow Lib "user32" () As LongPtr

Public Sub ShowActiveWindowHandle()
    Dim windowHandle As LongPtr
    windowHandle = GetActiveWindow()
    Debug.Print "Active window handle: " & windowHandle
End Sub

10. The sheet or workbook is protected

Symptom: run-time error 1004 when writing, sorting or inserting rows.

Cause: protection applies to macros too, unless Worksheet.Protect is called with UserInterfaceOnly set to True.

Fix: unprotect and reprotect inside the macro, or use UserInterfaceOnly:=True. That setting can be lost after a save and reopen (Microsoft's page describes this for earlier versions), so reapply it on open. Protect also resets any Allow options you don't pass, so include the ones the sheet uses. Put this in ThisWorkbook and change the sheet name; if the module already has a Workbook_Open, merge these lines into it rather than adding a second one:

Option Explicit

Private Sub Workbook_Open()
    Dim ws As Worksheet

    On Error GoTo Failed
    Set ws = Me.Worksheets("Journal")
    ' Keep only the Allow... options this sheet needs
    ws.Protect UserInterfaceOnly:=True, AllowFiltering:=True
    Exit Sub

Failed:
    MsgBox "Could not reapply protection: " & Err.Description, vbExclamation
End Sub

A password-protected sheet needs Password:=, which anyone who opens the VBA editor can read.

11. ActiveX buttons and controls are disabled by default

Symptom: a BLOCKED CONTENT bar, and ActiveX buttons or combo boxes do nothing.

Cause: in Microsoft 365 and Office 2024, ActiveX controls are disabled by default. The setting is shared across Office apps.

Fix: replace ActiveX buttons with Form Control buttons (Developer > Insert > Form Controls), moving the click code into a Public Sub in a standard module. Whether UserForm controls are affected isn't documented, so test yours.

12. The macro depends on VBScript (RegExp or .vbs files)

Symptom: regular expressions (say, pulling invoice numbers from bank narrative) or a .vbs call fail on one PC. Look for the "Microsoft VBScript Regular Expressions 5.5" reference, CreateObject("VBScript.RegExp") or wscript.

Cause: Microsoft is phasing VBScript out of Windows. Its September 2025 post says it will be off by default in approximately 2026 or 2027. At full removal (date not set), .vbs calls from VBA stop being supported and VBScript RegExp references break unless Office is on a supported build.

Fix: Microsoft 365 Version 2508 (Build 19127.20154) and later include RegExp, Match, MatchCollection and SubMatches natively; don't assume older versions do. Replace .vbs calls with VBA. Scripting.Dictionary and FileSystemObject are unaffected.

How to fix a run-time error (the Debug button)

When a macro hits a run-time error, Excel shows the error number with End and Debug buttons. Click Debug to open the VBA editor with the failing line highlighted in yellow, fix that line, then press F5 to continue or Run > Reset to stop. Common numbers:

• 9, Subscript out of range: often a sheet or workbook name that doesn't exist (renamed or misspelt).
• 13, Type mismatch: often text in a cell the code treats as a number.
• 91, Object variable not set: a missing Set, or an object that is Nothing, such as a failed Find.
• 1004: has many causes; a protected sheet (check 10) is a common one.

Debugging VBA in Excel: how to debug a macro step by step

If the macro runs but gives wrong numbers, open the VBA editor with Alt+F11 and:

1. Step through it: click inside the macro and press F8. The yellow line runs next; Shift+F8 steps over a call.
2. Set a breakpoint: F9 on a line, then F5 runs to it.
3. Inspect values: hover over a variable, open View > Locals Window, or type ?variableName in the Immediate window.
4. Log and assert as it runs: Debug.Print writes to the Immediate window without stopping. Debug.Assert total >= 0 pauses on that line only when the condition is False (Assert method).
5. Unmask hidden errors: if On Error Resume Next hides failures, tick Tools > Options > General > Break on All Errors, then switch it back.
6. Stop a runaway loop with Ctrl+Break.

VBA debugging tools compared

For more code-inspection tools, see Rubberduck VBA alternatives.

How HISAB 360 helps diagnose a broken macro

HISAB 360 is an AI assistant inside Windows desktop Excel. Two of its tools help with code-level causes such as checks 6, 7 and 9. They can't fix a blocked file or a policy setting, or see whether events are currently off in your Excel session.

Lint across the whole project. The AI can run HISAB's VBA linter over every module: 142 static inspections, including compile-error and near-compile checks that overlap check 7's table (undeclared variables, calls to procedures that don't exist in any module, the Dim a, b As Long trap, ByRef argument type mismatches, a missing Set, wrong argument counts). Others flag event handlers in the wrong kind of module, EnableEvents or ScreenUpdating switched off with no line anywhere in the procedure that switches it back on (a restore that an error skips isn't caught), Declare without PtrSafe, and On Error Resume Next left on. Most late-bound Object code isn't member-checked, so typos there can slip through.

A test run on a copy. The sandbox test copies the saved workbook, opens the copy in the background, applies a proposed fix, runs a compile probe and any smoke-test macros you choose, reports, and deletes the copy. Your live workbook's code isn't changed; to keep the fix, the AI applies it to the real file.

The limits, plainly:

• It is static analysis, not the VBA compiler, and can miss real compile errors. It reports; the AI explains and rewrites. When the AI uses its write or replace macro tools, a lint gate undoes the change on Error-level findings; it can occasionally reject valid code, and imported modules or form templates aren't gated.
• The sandbox compile is a probe, not a guaranteed full-project compile. It can be inconclusive if Excel is busy or report a macro-security block as a compile error, and a pass with no smoke tests isn't proof the macro works. A window may flash up briefly. Unsaved changes are saved first, and smoke-test macros run for real, so effects outside the workbook aren't sandboxed.
• It doesn't set VBA references, change Trust Center, Mark of the Web or ActiveX settings, or work inside a password-protected VBA project (unlock it first under Tools > VBAProject Properties > Protection).
• You opt in: HISAB's macro permissions are off by default (editing needs Edit plus Run), you tick "Trust access to the VBA project object model" (Microsoft calls it a possible security hazard), and the code must be in a module of a macro-enabled workbook. Windows desktop Excel only.

Good for: finance teams maintaining inherited multi-module workbooks. Not for: a single blocked download (checks 1 and 2 are free), Mac or browser users. See how to generate VBA macros from chat in HISAB or try the free VBA macro generator.

Frequently asked questions

Try HISAB 360 on your own workbook

HISAB 360 is an AI assistant inside Windows desktop Excel for accountants and finance teams. It connects two-way to QuickBooks, Xero, Zoho Books, Odoo and FreshBooks. The 15-day trial is the full product, no card required.