# Settings Sync (Beta)

## How to toggle settings sync

* You can toggle Settings Sync within the **Settings** > **Account** pane
* Through the [Command Palette](https://docs.warp.dev/terminal/command-palette) by searching for “Settings Sync”

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-662986453e3d04b84693ebfa18afc07802c85cdf%2Fsettings-sync-account.png?alt=media" alt=""><figcaption><p>Settings Sync in Account pane</p></figcaption></figure>

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-15ccabe97d60491d7005c4f1c7fd8243bf48d542%2Fsettings-sync-palette.png?alt=media" alt=""><figcaption><p>Settings Sync in Command Palette</p></figcaption></figure>

## How settings sync works

**Settings Sync** works by syncing the state of most of your Warp settings to our cloud servers.

When you log in to Warp on another device or through the browser with [Session Sharing](https://docs.warp.dev/knowledge-and-collaboration/session-sharing), if you have Settings Sync enabled, most of your settings will be the same as they were when you were logged in before.

That means your themes, most features, privacy settings, AI settings, **are all the same everywhere you use Warp**, saving you the time from having to set them up again.

When you first enable Settings Sync, the settings from the computer you enabled it on becomes the default settings for all devices. This is true if you toggle Settings Sync off and on as well - the synced settings are always from **the last device you enabled Settings Sync on**, so toggling effectively causes all of your devices to have settings from the current logged in instance.

{% hint style="info" %}
Read more about privacy for cloud features in the [privacy overview](https://www.warp.dev/privacy/overview).
{% endhint %}

### Non-synced settings

Not all settings are synced, however. Notably, Warp does not sync:

* Custom keybindings (we may in the future). Although, you can set [custom keybinds with a file](https://docs.warp.dev/getting-started/keyboard-shortcuts#custom-keyboard-shortcuts)
* Custom themes (we may in the future)
* Device specific settings (e.g. what editor you prefer using, startup shell)
* Platform-specific settings are synced across devices on the same platform (e.g. your settings for how to interact with the Linux clipboard are synced across all Linux devices, but not on macOS, Windows, or Web).

You can tell when a setting is not synced because it will have a special cloud strikethrough icon in the settings panel.

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-697734a14c0718b40ea2513bfdbe2d6ce8d1ea82%2Fsettings-not-synced.png?alt=media" alt=""><figcaption><p>Settings not synced</p></figcaption></figure>


---

# 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/terminal/more-features/settings-sync.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.
