# Sync on iPhone

When the phone syncs, what arrives from the Mac, what the banner means, and working offline.

On the phone, sync is on from the start. Everything you keep on the Mac arrives on the phone, and the other way round, through Copilka's service. It needs a plan that includes cloud storage; without one the phone keeps its own copy and says so.

For how the service stores what it holds, see [Encryption and the cloud](https://docs.copilka.app/account/encryption/).

## When the phone syncs

A change made on the phone goes up within seconds. New things come down:

- when the app launches,
- when you sign in,
- when the app comes to the front, which is also when saves from the share sheet are picked up,
- every minute while the app is open,
- and when you pull down on Home or any board.

The Mac does the same, every ten minutes. Nothing runs while the app is in the background.

## What arrives from the Mac

Every record comes over: items, rooms, tags, readings, properties, and the settings that are shared between devices. Settings that belong to one device, like what the app opens on, stay where they are.

Files are the one thing that needs explaining. On the Mac a file is referenced where it sits on disk, and, when your plan includes cloud storage, the Mac uploads a copy of it. On the phone:

- **Pictures up to 10 MB download by themselves**, after each sync pass and as soon as their card appears.
- **Covers you chose on the Mac** download by themselves too.
- **Other files** show *In the cloud* on their card and **Download** on the item screen. Once downloaded they open in Quick Look and stay on the phone.
- **A file the Mac never uploaded** shows *Missing* on the card and, on the item screen, *The file is not on this phone and not in the cloud.*

Some link previews saved on the Mac point at picture addresses that have since gone, for example place photos from a map. The Mac still shows its cached copy; the phone shows none.

## The banner

Home and every board show a banner when sync needs attention, and none when it does not. Tapping it opens the Sync page, where the same words appear under **Status**.

| It says | It means |
| --- | --- |
| **Sync is off** | The switch on the Sync page is off. *This phone keeps its library to itself.* |
| **Signed out** | Sign in to keep the phone in step. |
| **Not synced yet** | Signed in, but no pass has completed yet. |
| **Syncing…** | A pass is running. |
| **Not included** | *Cloud storage is part of the subscription. This phone keeps its own copy.* |
| **Offline** | *The service could not be reached. It catches up when the phone is back on the network.* |
| **Could not sync** | The reason follows. |

When all is well the Sync page reads **In step**, with how long ago.

## Offline

The whole library lives on the phone, so you can browse and edit without a connection. Changes queue up, and the Sync page counts them: *One change waiting to go up.* Reading a new page needs the network, so a link saved offline is read when you are back on it.

## Opens on

Settings → General → **Opens on** chooses the screen the app starts on: **Home**, a smart view, a kind, a room or a tag. It is a setting of this phone's own and does not sync; the Mac has its own. If the room or tag you chose is later deleted, the app opens on Everything.

---

This page: https://docs.copilka.app/iphone/sync/ · As Markdown: https://docs.copilka.app/iphone/sync.md · Every page: https://docs.copilka.app/llms.txt
