---
title: "How to Sync Text Snippets Between Macs"
slug: sync-snippets-between-macs
url: https://refrainformac.com/guides/sync-snippets-between-macs
category: "How-To Guide"
published: 2026-11-04
updated: 2026-11-04
---

# How to Sync Text Snippets Between Macs

> To sync snippets between Macs with Refrain, keep its snippet file in a folder that syncs. On the first Mac, open Settings, click Move File… and pick a folder in iCloud Drive. On each other Mac, click Choose File… and pick the same file. Refrain reloads the file whenever it changes, so new snippets show up everywhere after the sync.

## If you use Apple Text Replacements

Text Replacements live in **System Settings > Keyboard > Text Replacements**. Apple says you can keep them up to date on all your Apple devices, and its "Back up and share text replacements" page explains how. If an entry shows up on one Mac and not another, follow that page rather than retyping entries by hand.

Text Replacements suit short codes. If what you reuse is longer, like email replies, addresses, templates or commands, a snippet file you control is easier to keep the same everywhere.

## Sync Refrain snippets with iCloud Drive

Refrain keeps every snippet in one markdown file, and you choose where that file lives. Put it in a folder that already syncs and every Mac reads the same list.

On the Mac that already has your snippets:

1.  Open Refrain's **Settings** from the menu bar icon (or press Cmd-, in Refrain).
2.  Click **Move File…** and pick a folder in iCloud Drive. Refrain writes the file there, moves the old copy to the Trash and keeps working from the new location.

On each other Mac:

1.  Install Refrain and open it.
2.  In **Settings**, click **Choose File…** and pick the same file in iCloud Drive.

From then on, a snippet added on one Mac appears on the others once iCloud Drive has synced the file. Refrain watches the file and reloads it when it changes, so there's nothing to refresh.

Note

Dropbox works the same way: move the file into your Dropbox folder on one Mac and choose it on the others. Any folder that syncs a plain file will do.

## Keep snippets in git

If you already keep dotfiles or notes in a git repo, put the snippet file there instead. You get a history of every change and can see exactly what changed in a diff, because the file is plain text with a short header per snippet:

```
---
name: mailing-address
---

[Your name]
[Street address]
[City, State ZIP]

----
```

Pull on each Mac and Refrain picks up the new version. This also works for a team that wants to share one reviewed set of replies.

## Tips that avoid surprises

-   **Edit on one Mac at a time.** If two Macs change the file before the sync finishes, the sync service has to pick a version, and one set of edits can end up in a conflicted copy.
-   **Use Show in Finder** in Refrain's Settings to check which file a Mac is using.
-   **Bulk edits are fine anywhere.** Open the file in any text editor on any of your Macs; the others follow after the sync.

## What about iPhone and iPad?

Refrain is a Mac app, so it doesn't run on iPhone or iPad. If the file is in iCloud Drive, you can still open it in the Files app to read or copy something on the go, because it is plain text.

For how Refrain and Apple's built-in feature compare overall, see [Refrain vs Apple Text Replacement](/guides/refrain-vs-apple-text-replacement).

## Frequently asked questions

How do I use the same snippets on two Macs?

With Refrain, put the snippet file in iCloud Drive or Dropbox using Settings > Move File… on the first Mac, then choose the same file with Settings > Choose File… on the second. Both Macs read the same list.

Do changes show up right away on my other Mac?

As soon as the sync service has copied the file. Refrain watches its snippet file and reloads it when it changes, so you don't need to restart or refresh anything.

Can I keep my snippets in a git repo?

Yes. Refrain's snippet file is plain markdown, so it can live in any repo. Pull on each Mac and Refrain picks up the new version.

Does Refrain sync to iPhone?

No. Refrain is a Mac app. If the snippet file is in iCloud Drive, you can open it in the Files app to read it on an iPhone or iPad.

## FAQ

### How do I use the same snippets on two Macs?

With Refrain, put the snippet file in iCloud Drive or Dropbox using Settings > Move File… on the first Mac, then choose the same file with Settings > Choose File… on the second. Both Macs read the same list.

### Do changes show up right away on my other Mac?

As soon as the sync service has copied the file. Refrain watches its snippet file and reloads it when it changes, so you don't need to restart or refresh anything.

### Can I keep my snippets in a git repo?

Yes. Refrain's snippet file is plain markdown, so it can live in any repo. Pull on each Mac and Refrain picks up the new version.

### Does Refrain sync to iPhone?

No. Refrain is a Mac app. If the snippet file is in iCloud Drive, you can open it in the Files app to read it on an iPhone or iPad.
