# Cloud Sync

> Available on: Mac, Windows, iOS
> Tier: Pro

Cloud Sync keeps your Raycast data — Quicklinks, Snippets, Notes, AI chats, themes, and more — consistent across all your devices and apps.

Cloud Sync is currently in alpha and available to Raycast Pro subscribers. Availability may be limited while it rolls out. Available in Raycast for Mac (both the v1 and v2 apps), Raycast for Windows, and Raycast for iOS.

## Getting Started

> [!WARNING]
> Before turning on Cloud Sync, run the **Export Settings & Data** command to create a backup of your current setup. This makes sure you have a safe copy of your data to restore from in case anything goes wrong during the initial sync.

### Join the Cloud Sync Alpha channel

Join our [Raycast Slack Community](https://app.slack.com/client/T0194883WF8) and make sure you are part of the [Cloud Sync Alpha channel](https://raycastcommunity.slack.com/archives/C0BCFNUDNNA). If you are not part of the channel, please DM **@David** or **@Tirta**.

  **Please don't post anything about it publicly, including on social media. Keep all discussion within this group for now.**

### Migrate from Raycast v1

If you're a macOS v2 user and haven't run the **Migrate from Raycast v1** command, please do so. Ignore this if you're a Raycast Windows user or a macOS v2 user with your app already set up.

### Back Up Your Data

Run the **Export Settings & Data** command to create a backup of your current setup. We also recommend enabling [scheduled Export Settings & Data](/import-export#scheduled-exports) so you always have a recent backup.

### Sign In to Your Raycast Account

Make sure you're signed in to your Raycast account in **Raycast Settings → Account** (a Pro subscription is required).

### Open the Cloud Sync Sidebar

Open **Raycast Settings** (`⌘`/`Ctrl` `,`), then go to the **Cloud Sync** sidebar.

### Turn Cloud Sync On

Use the toggle in the top-right corner to enable or disable the Cloud Sync feature entirely. Once enabled, choose which categories you want to keep in sync.

> [!NOTE]
> Cloud Sync requires a signed-in Raycast Pro account. If you sign out or your session expires, syncing pauses and resumes automatically once you sign back in.

![The Cloud Sync settings tab with the enable toggle turned off and the alpha backup reminder](/images/app/basics/mac-settings-cloudsync.png)

## Overview

Cloud Sync keeps your Raycast data consistent across all your devices and apps. Once enabled, the things you create and customize in Raycast (Quicklinks, Snippets, Notes, AI chats and presets, themes, window layouts, and more) are stored in the cloud and automatically kept up to date everywhere you are signed in. It syncs across the Raycast for Mac v1 and v2 apps, the Raycast for Windows app, and the Raycast for iOS app, so a change you make in one app shows up in all the others, without manual exports or backups.

Cloud Sync runs continuously in the background. Changes are captured locally and replicated through Raycast's sync service, so your devices stay in sync even after being offline. You choose which categories of data to sync and can turn each on or off at any time.

![The Cloud Sync settings tab with sync enabled, showing Synced Devices, Synced Content, and the items that are not synced](/images/app/basics/mac-settings-cloudsync-enabled.png)

## What Syncs

In the Cloud Sync settings, the Synced Content screen is where you control what's kept in sync. Each row shows a live count of how many items are currently synced and a toggle to turn that category on or off. The categories include:

- **AI Commands & Agents**
- **AI chat history**
- **MCP servers**
- **Quicklinks**
- **Snippets**
- **Raycast Notes**
- **Window management layouts**
- **Themes**
- **General Settings** (Open at Login, Show in Menu Bar, Appearance, and Window Mode)
- **Extensions** (settings, commands, and hotkeys)

> [!TIP]
> Some preferences are synced by default and can't be turned off, such as Other General Settings and Root Search Ranking. AI Chat History also always keeps the AI models and folders it depends on in sync, even if you turn off AI Commands & Agents.

![The Synced Content screen listing each category with its item count and sync toggle](/images/app/basics/mac-settings-cloudsync-syncedcontents-content.png)

## Not Synced

- **Clipboard History**
- **Screenshots**
- **Search Ranking**
- **Search History**
- **Window Activation Behavior**
- **Export / Backup Settings** (Export Passphrase, Scheduled Backup, Backup Location, Auto-Delete)
- **Script Commands** (scripts only; their settings sync)
- **Credentials & Passwords**

## Managing Your Devices

The Cloud Sync settings show every device connected to your account. From there you can:

- Rename a device so it's easy to recognize.
- Deauthorize a device with v2 app to stop it from syncing and revoke its access. The next time that device starts, it stops syncing and clears its local synced state.

The Synced Devices screen lists every device connected to your account. Each entry shows the device name, platform, app version, and when it last synced. Your current device is marked **This Device**, and you can remove any other device with the ✕ button next to it.

> [!NOTE]
> Legacy Raycast Devices groups together all of your v1 devices in a single entry (your macOS v1 and iOS Cloud Sync). You can't enable or disable individual v1 devices from here. The Cloud Sync settings shown here are exclusively part of v2, and Cloud Sync v2 for iOS is coming soon.

![The Synced Devices screen listing each connected device with its platform, app version, and last sync time](/images/app/basics/mac-settings-cloudsync-synceddevices.png)

## Turning Cloud Sync Off

Turning Cloud Sync off on a device stops data from syncing. Any data previously synced to that device will remain on it, and your data will stay available in the cloud and on other synced devices.

## Privacy & Security

Synced data is tied to your Raycast account and is encrypted on your local device DB, in transit, and on the server's DB.

## FAQ

### Do I need a Raycast Pro subscription?

Yes. Cloud Sync is a Pro feature and is currently in alpha.

### Can I choose what gets synced?

Yes. Each category (Quicklinks, Snippets, Notes, AI history, themes, and more) can be turned on or off independently in the Cloud Sync settings.

### What happens to my data if I turn Cloud Sync off?

Your data remains in the cloud and on your other synced devices. Only the local synced state on the device you disabled is cleared; it is restored when you re-enable Cloud Sync.

### Which platforms are supported?

Cloud Sync works across the Raycast for Mac v1 and v2 apps, the Raycast for Windows app, and the Raycast for iOS app. Data you create or change in any one of them is kept in sync with all the others.

### Are there any known issues?

- The Quicklinks `openWith` field is not synchronized between Windows and macOS.

  Apps on the Mac are not the same as on Windows. Therefore we don't synchronize this field between different platforms and fall back on the "default app" for the link. Once you have assigned an app on a specific platform, that app is remembered for that platform.

- The Quicklinks `openWith` field is not bridged between v1 and v2 devices.

  v1 used to define apps with bundle identifiers, while v2 uses file paths. This is done to overcome issues where you have installed several apps with a similar bundle ID (e.g. Xcode). Therefore, the Quicklink app is not synchronized between v1 and v2, although it is synchronized between v2 devices.

- Settings, categories, hotkeys, and extension state can be clobbered during the enroll merge.

  We are working on mitigating these enrollment issues, but during the alpha/beta period a hotkey or setting might revert to its default when you set up a new Raycast.

- Opening an unchanged note has been reported to overwrite newer edits.

  This commonly happens on iOS devices. We will fix this soon.

- Cross-device data can look stale or missing during catch-up.

- Duplicate entities may appear due to v1-to-v2 migration.

  Cloud Sync has a de-duplicator, but it is intentionally conservative during the alpha/beta period.

- Window-layout bridging between v1 and v2 is lossy.

  App identity, Quicklink arguments, and some file URL names can be dropped.

- Hotkey conflict detection is incomplete.

  Same-platform hotkey sync is supported, but cross-platform behavior and conflict handling still need clearer UX.

## How to Give Feedback

Cloud Sync is in alpha, so your feedback is especially valuable. Please report bugs and share suggestions in the [Cloud Sync feedback channel](https://raycastcommunity.slack.com/archives/C0BCFNUDNNA) in the [Raycast Slack Community](https://app.slack.com/client/T0194883WF8). For access to the private channel, please DM **@David** or **@Tirta**.

**Please don't post anything about it publicly, including on social media. Keep all discussion within this group for now.**

For most issues, sharing your Raycast logs with us is also incredibly helpful. We have a couple of commands to make it easy for you to access them.

- `Copy Raycast Logs` — Copies your latest two log files to the clipboard
- `Reveal Raycast Logs` — Open your log folder for you to find all of your logs.

**Where to Focus Your Testing and Feedback**

Our top priority right now is fixing bugs and addressing performance issues. Once this is stable, we will focus on closing feature parity gaps and then work on improvements and new features in this version.

As you try Cloud Sync and test it for us, please keep these priorities in mind and, as much as possible, please help us focus on bugs and performance. Also, if you notice small things that are missing but would be useful to you, please let us know; that feedback is very helpful.

**Feedback Format**

When sharing feedback with us in Slack, please aim to follow the following two suggestions to help us triage these issues with you:

- Share **one bit of feedback per message** so that it is easier to collaborate with you on it. Or at least group feedback per feature in one message where possible.
- Please prefix these messages with either **[BUG]** or **[FEATURE]**.


---

## Need Help?

Contact Raycast Support if you have any questions or would like help with Cloud Sync. Use the **Send Feedback** command directly in Raycast to report bugs and billing issues, log feature requests, or any other queries you would like to speak to us about.

You can view all Raycast Support contact options at https://manual.raycast.com/contact-support