> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How Bloc Works Offline: Auto-Save and Background Sync

> Bloc saves every note to your device instantly, even without internet. When you reconnect, changes sync automatically in the background.

Bloc is built around the idea that your notes should always be available — whether you're on a plane, underground, or simply dealing with spotty Wi-Fi. Every note you write is saved directly to your device the moment you type it, with no manual save button and no dependency on an internet connection. When you come back online, Bloc quietly syncs your changes to the cloud in the background.

## How It Works

Bloc uses your device's local storage as the primary home for your notes. Whenever you create or edit a note, Bloc writes the change to your device immediately and keeps track of any changes that haven't reached the server yet. As soon as a connection is detected, those pending changes are sent automatically.

When you reconnect, Bloc runs a full sync cycle:

<Steps>
  <Step title="Push your changes">
    Bloc sends any notes you created or edited while offline to the server.
  </Step>

  <Step title="Process deletions">
    Notes you deleted while offline are removed from the server.
  </Step>

  <Step title="Pull server updates">
    Bloc fetches the latest state from the server and updates your local copy with any changes made on other devices.
  </Step>
</Steps>

## Writing Offline

You can create, edit, and view all your notes with no internet connection. Bloc behaves exactly the same offline as it does online — open a note, start typing, and your work is saved. When the app detects that you're offline, it shows a subtle status indicator so you know your changes are queued for sync rather than live.

You don't need to do anything differently when you're offline. Bloc handles the transition automatically when your connection returns.

## What Gets Synced

Every part of your note is synced automatically when you reconnect:

| Field                          | Synced |
| ------------------------------ | ------ |
| Note title                     | ✓      |
| Note content (rich text)       | ✓      |
| Tag                            | ✓      |
| Created and updated timestamps | ✓      |

## Conflict Resolution

If you edit the same note on two different devices while one is offline, Bloc compares when each version was last saved. **The most recently saved version wins** and becomes the authoritative copy across all your devices. The older version is discarded.

To avoid accidental overwrites, try to sync one device before picking up work on another.

<Tip>
  For the smoothest offline experience, [install Bloc as a PWA](/installation) on your device. The installed app caches the full interface and works reliably even when your browser is closed.
</Tip>
