AutoHotkey Not Working? Common Errors & Fixes
The 10 AutoHotkey problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
AutoHotkey v1 Script Not Working in v2
Workaround availableWindowsv2 is not backward compatible, so v1 scripts fail or do nothing. Install v1 for old scripts, or port the syntax and add #Requires so the right version runs.
AutoHotkey Error: This Line Does Not Contain a Recognized Action
Workaround availableWindowsThis error almost always means v1-style code is running under v2. Fix the syntax or run the script with the matching version.
AutoHotkey Hotkeys Not Working in Admin Windows
Workaround availableWindowsWindows UAC blocks normal scripts from elevated windows. Run the script with UI Access (best) or as administrator.
AutoHotkey Flagged as Virus by Antivirus
OngoingWindowsAHK and compiled scripts are often false positives. Verify on VirusTotal, report to the vendor and add an exclusion for your own file.
AutoHotkey Anti-Cheat Errors and Bans in Games
OngoingWindowsMany anti-cheat systems block or flag AHK. Close it before launching the game, and avoid scripts that give gameplay advantage.
AutoHotkey Send and Click Not Working in Games
Workaround availableWindowsGames often ignore normal simulated input. Try longer key delays, down/up events or ControlSend; some anti-cheat games block it entirely.
AutoHotkey Modifier Key Stuck (Ctrl, Alt, Shift, Win)
Workaround availableWindowsSend can re-press a modifier you already released. Use SendEvent, add small delays and tap the modifiers to clear it.
AutoHotkey Hotkeys Not Working on Non-English Keyboard Layouts
Workaround availableWindowsLetter hotkeys depend on the active layout. Bind by scan code (for example sc010) so the hotkey works on any layout.
AutoHotkey Script Slow or Laggy Under High CPU
Workaround availableWindowsHotkeys can lag when the PC is busy. Raise the script's process priority and trim slow loops.
How to Run an AutoHotkey Script at Startup
Workaround availableWindowsPut a shortcut to the script in your Startup folder (shell:startup). Use Task Scheduler if it must run elevated.
Problem not listed? See all AutoHotkey complaints or compare AutoHotkey alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like AutoHotkey: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code