# Keep your library in iCloud

Use saved work on your Apple devices and keep local work when offline.

Canonical: https://roboty.dev/guide/use/icloud-sync
Content revision: 9
Platforms: iphone, mac

## Turn on iCloud sync

If your installed build offers iCloud sync, open Home → Settings → Library & Sync on iPhone or Settings → Library & Sync on Mac. Read what will be included, then choose Turn on. Use the same Apple Account on your devices. You do not need a Roboty account or a paired Mac to read your saved library.

Your existing local work is kept. The Turn on confirmation explains that existing iCloud content and work on this device will be combined. Matching names do not replace existing items.

## What follows you

Supported saved projects, reusable robots, tasks, methods, scenes, templates, experiments, notes and completed discussions can sync. Saved unresolved work can remain editable even when it cannot run on that device. Completed result summaries keep their original source and outcome. The iPhone Control detail choice also follows your library. Appearance follows each device’s system setting. Guidance, setup choices and permissions remain local.

Unsubmitted questions, unfinished input, local robot connections, calibration and permissions stay on their original device. Sync does not move a running attempt or make a robot ready. Use the original Mac connection for live status and Stop.

## Work offline

Keep working while offline. Once a save succeeds, the change stays on that device and waits for a connection. Other devices may receive it later. Open Roboty on your Mac to transfer its pending changes. Sync does not run after the Mac app quits.

If iCloud storage is full, your durably saved local changes remain available. Follow the specific status in Settings. A local storage error needs attention before the app can confirm a save.

## Review two versions

If the same work changes on two devices, both versions are kept. Open Home → Settings → Library & Sync → Review library and versions on iPhone, or Settings → Library & Sync → Review library and versions on Mac. On Mac, saved work and versions opens in the main window. Select a record to inspect its versions. Back returns to Library & Sync. Inspect the retained versions, then choose Use this version for the intended work. Receiving a change does not replace what you are typing. New versions of a reusable setup or template do not silently change existing experiments.

## Recordings and other large files

Large recordings and datasets stay at their source until you select them. In Settings, open Library & Sync, then choose Keep a file in iCloud, select one file and review its name and size. Choose Keep in iCloud to upload it. The limit is 64 MB per file. On another device, choose Download for an available file, then Save a copy if needed. A result summary may be present before its recording is available.

A source-only recording still needs its original device. Download cannot recover bytes that were never uploaded. Removing a downloaded copy is different from deleting your original work.

## Continue a saved discussion

Choose Continue discussion and review the history to include. On Mac, this review stays in the main window and the new discussion opens in Assistant. A new discussion opens on your selected Mac through the normal connection and provider permissions. It does not replay an earlier Send or resume an uncertain request. An existing draft or pending message must be handled first.

## Turn off or change accounts

Turning off stops future sync on this device and keeps local work. It does not delete your iCloud copy. Re-enabling reconciles retained changes.

If your Apple Account changes, review the recovery choices in Library & Sync on Mac, or choose Review account on iPhone. You can sign back into the original account and try again, keep using the library offline, or use a separate library.

On Mac, Saved libraries shows the Current library and any library selected for restart first. Expand Other libraries when shown to browse the rest. Choose Switch beside another library, or Create a separate library, then confirm the named choice. Finish pending changes and turn off background availability first. The selected library opens after you close and reopen Roboty. Until then, Current library still names the running library. The new library starts with sync off. Previous work and queued changes stay in their original library. On iPhone, Manage saved libraries selects a library for the next app launch.

If the cloud copy is missing or cannot be opened, keep local work and follow the recovery message. Rebuild from this device creates a new cloud copy only after confirmation. Files that existed only in the previous cloud copy may be unavailable.

Forget from synced library removes supported saved content and its managed sync copies after confirmation. Immutable source records and work pinned by experiments or pending operations cannot be forgotten through this control. It does not erase original files outside Roboty or promise immediate deletion from an offline device.

## Sharing is a separate choice

Personal iCloud sync does not share work with another person, publish it or send it to a model provider. Use [selected sharing](/guide/use/sharing) to review exactly what a recipient receives. Read [Privacy](/privacy) for storage and removal choices.

If the other computer uses a different Apple Account or cannot use iCloud, use a reviewed selected file instead. Import creates independent local copies. It does not merge or automatically keep two libraries in sync. A selected file is not a full backup.

Content ID: icloud-sync
Compiled digest: 9c95496672038d4be0a9fb21e172ecf2f50fdc39acfea369fb131e41314c7ecd
Language: en