Migrate to Warp
Learn how to import settings from other terminals when you switch to Warp.
Last updated
Learn how to import settings from other terminals when you switch to Warp.
Last updated
You can easily import your settings from iTerm2 to Warp. This includes custom keybindings and color themes.
When you run Warp for the first time, you will get the option to import your default profile from iTerm2.
Select iTerm2 Profile: Default to import your settings.
Warp will only import settings associated with the Default profile.
If you are already running Warp but would like to import your iTerm2 profile, you can open the Command Palette and search for the Setup Guide. This will enter you into the workflow to import your settings.
Next, you can choose your prompt and decide whether or not to inherit your existing prompt configuration. There are two prompt options:
Warp prompt: This is Warp's native prompt that you can customize to meet your needs. In Settings > Appearance > Prompt, you can drag and drop context chips into your Warp prompt to display specific information, like git branches or timestamps.
Shell prompt (PS1): This custom prompt inherits your pre-existing prompt configuration. Select this option if you want your Warp prompt to match your settings from iTerm2.
After choosing a prompt, you’re ready to start using Warp.
After importing your iTerm2 profile and choosing your prompt, you might have additional settings from iTerm2 that you would like to configure. For example:
Customizing your dedicated hotkey window, allowing you to customize your windows relative to your active screen size.
Dividing and organizing tabs into multiple panels or terminal sessions.
Setting up your keyboard shortcuts and completion suggestions.
You can find more information on these behavior settings in our Quickstart guide.
