# Migrate to Warp

## From iTerm2

You can easily import your settings from iTerm2 to Warp. This includes custom keybindings and color themes.

To do so, you can open the [Command Palette](https://docs.warp.dev/terminal/command-palette) and search for Import External Settings. This will enter you into the workflow to import your settings.

Select **iTerm2 Profile: Default** to import your settings.

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-355fb38a9eca18812a736fe79f11c7ee142ec30f%2Fmigrate-to-warp.png?alt=media" alt=""><figcaption><p>Select a settings profile to import</p></figcaption></figure>

Warp will only import settings associated with the Default profile.

### Choose your Prompt

Next, you can choose your [prompt](https://docs.warp.dev/terminal/appearance/prompt) and decide whether or not to inherit your existing prompt configuration. There are two prompt options:

1. [Warp prompt](https://docs.warp.dev/terminal/appearance/prompt#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.
2. [Shell prompt (PS1)](https://docs.warp.dev/terminal/appearance/prompt#custom-prompt): 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.

### Import additional settings

After importing your iTerm2 profile and choosing your prompt, you may have additional settings from iTerm2 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.warp.dev/getting-started/migrate-to-warp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.