macOS

Where Does iTerm2 Store Profiles and Preferences?

iTerm2 preferences plist and DynamicProfiles folder on Mac, including the custom-folder option for dotfile syncing.

Last updated

iTerm2 stores preferences in a plist under Preferences, keyed by its bundle identifier. Profiles, colors and window arrangements all live there.

Power users usually redirect this to a custom folder for syncing. The plist path below is the default before any redirect.

Where iTerm2 stores this, by platform

macOS
~/Library/Preferences/com.googlecode.iterm2.plist

Default location before any custom-folder redirect. Check Preferences > General > Settings for the live path. DynamicProfiles JSON files live in ~/Library/Application Support/iTerm2/DynamicProfiles.

Frequently asked questions

How do I sync iTerm2 settings between Macs?

Enable Preferences > General > Settings > Load preferences from a custom folder, and point it at a synced directory. Commit that folder to version control for real backup.

What are DynamicProfiles?

Add JSON profile files to the DynamicProfiles folder. iTerm2 loads them at launch without touching the main plist. Ideal for work versus personal profile splits.

Notice an outdated path? Let us know.