# How offline sync works

Category: Field work. Updated 2026-11-13.

Cablefolio is built to be used where there is no signal, and this page explains what it keeps on your phone, how the changes you make offline reach everyone else, and why it never guesses when two people changed the same thing.

## What your phone keeps

When you press **Keep offline** on a property, the whole property is copied to the phone: its rooms, racks, devices, runs, links, notes, checklists, each photo's thumbnail, and each file small enough to keep. Pages you opened with a signal are kept too, so they open again without one.

The copy lives in your browser's storage, in a separate store for each account that signs in on the phone. It never holds a device's credentials, a property's access codes, an API token, or a webhook secret — only whether one exists. Signing out deletes it, and so does a signed-out session: if an admin signs your account out everywhere, the phone's copy is cleared the next time it reaches the server.

## How changes are sent

Each change you make with no signal is saved on the phone and shown on the page straight away, then waits in a queue. When the browser is back online the queue sends itself, oldest first, and stops at the first change that does not land, so a device added to a new room never arrives before its room.

A change sent over a connection that drops part-way is never applied twice: each one carries its own key, and the server answers a repeat with the reply it already gave. A change whose outcome is uncertain waits for you rather than being sent again on its own.

## Refused changes

A change that breaks a rule — a VLAN tag already used, a port already taken — is marked **Refused** with the server's own reason. Fix the cause and press **Try again**, or press **Discard**. Nothing behind it is lost; it waits.

## Conflicts

If someone else changed the same record while your change waited, your change is held, not applied. Open **Settings › Offline**, compare **What you changed** with **What the server has**, and choose **Keep mine** or **Take theirs**. Neither is chosen for you: the edit made on site and the one that overtook it were both somebody's decision.

## Before you sign out

Signing out removes everything the phone kept, including changes still waiting. Send or settle them first: the line at the top of the screen says how many are waiting. For the steps, see [Offline](https://cablefolio.com/help/offline/).

## More help

- [Next: Reports and sharing](https://cablefolio.com/help/reports-and-sharing/)
- [Contact support](https://cablefolio.com/support/)