// troubleshooting guide · autohotkey

AutoHotkey Error: This Line Does Not Contain a Recognized Action

Status
Workaround available
platforms:
Windows
updated:
November 15, 2026
reports:
3
Method
how we research
Share

RUNBOOK · autohotkey/no-recognized-action-error3 FIXES

// quick answer

This error almost always means v1-style code is running under v2. Fix the syntax or run the script with the matching version.

Most likely fix: Match script and interpreter

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Match script and interpreter

    1. 01Add `#Requires AutoHotkey v2.0` (or v1.1) as the first line
    2. 02If it reports a version mismatch, run the file with the right AutoHotkey exe
    Did this fix it?
  2. FIX 2Fix v1-style lines

    1. 01Remove the comma after commands: `SetTitleMatchMode 3`
    2. 02Quote text arguments: `MsgBox "Hello"`
    3. 03Use `:=` for assignment
    Did this fix it?
  3. FIX 3Check shortcuts and tasks

    1. 01Open your Task Scheduler or shortcut
    2. 02Make sure it calls the v2 exe for v2 scripts
    Did this fix it?

Symptoms

Load error 'This line does not contain a recognized action' or 'Function calls require a space or ('.

Why it happens

  • C-01v1 commands such as `MsgBox, text` or `SetTitleMatchMode, 3` in a v2 script
  • C-02Code copied from an old tutorial or forum post
  • C-03Script launched with the wrong interpreter by a shortcut or scheduled task

// this guide also covers

  • autohotkey this line does not contain a recognized action
  • autohotkey function calls require a space or (
  • ahk v2 error

Still not working?

If AutoHotkey keeps failing, you're not alone. See every AutoHotkey problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch AutoHotkey Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other AutoHotkey errors

All 10 AutoHotkey errors and fixes →