Where Is the Warp Terminal settings.toml File?
Warp terminal settings.toml location on macOS, Windows and Linux, plus where themes and state live.
Last updated
Warp keeps preferences in a plain-text settings.toml you can edit by hand or version control. Edits apply immediately with no restart, and the Settings panel writes to the same file.
Each platform puts the file somewhere different, and Windows splits data across Local and Roaming. Back up settings.toml plus the themes and tab config folders to move machines cleanly.
Where Warp stores this, by platform
%LOCALAPPDATA%\warp\Warp\config\settings.toml
Stable channel path. Preview builds use WarpPreview in place of Warp. Portable data like themes and tab configs lives separately under %APPDATA%\warp\Warp\data.
~/.warp/settings.toml
Stable channel path; Preview uses ~/.warp-preview/settings.toml. Themes, tab configs and workflows sit alongside under ~/.warp. Keybindings live next door at ~/.warp/keybindings.yaml.
~/.config/warp-terminal/settings.toml
Stable channel path following XDG conventions. State, logs and the local database sit under ~/.local/state/warp-terminal, with portable data in ~/.local/share/warp-terminal.
Frequently asked questions
How do I open the Warp settings file?
In Warp, open Settings and click Open settings file at the bottom. That jumps to settings.toml for your platform and channel.
Which Warp files do I copy to a new machine?
settings.toml plus keybindings, themes and tab configs. Logs and the local database under the state directory are safe to leave behind.
Notice an outdated path? Let us know.