Migrate AutoHotkey v1 Scripts to v2

By AutoHotkeyTools Editorial Team · Updated October 6, 2026

Do not convert blindly

AutoHotkey v2 intentionally changed syntax and removed ambiguous legacy behavior. Test the script feature by feature.

Prioritize core logic

Start with hotkeys, functions, window commands, Send behavior, and variable handling before polishing secondary code.

Frequently asked questions

What is the first thing to check?

Convert legacy AutoHotkey v1 scripts by reviewing command syntax, expressions, functions, variables, and removed compatibility behavior.

Does this apply to AutoHotkey v2?

Yes. This guide is written with AutoHotkey v2 as the default unless a legacy behavior is explicitly mentioned.