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

# Offline Mode

> How Ambient sessions behave during network interruptions, what triggers offline mode, and recovery with the Web SDK

The Web SDK supports offline mode so ambient sessions continue during network interruptions. When the connection is lost, recording continues and audio is stored locally until connectivity is restored.

The SDK uses a **15-second buffer** before transitioning to offline mode. Use this delay to display a connection status notification (for example, **Connection unstable**) in your UI before the session goes fully offline.

## Common integration patterns and use cases

Design offline handling around automatic SDK behavior. The Web SDK buffers for 15 seconds, continues recording locally, and uploads after reconnect. Your application should surface status and expect delayed submission.

The following patterns show common ways to work with offline ambient in the Web SDK:

<CardGroup cols={2}>
  <Card title="Show Connection Status During the Buffer" icon="bell">
    Use the 15-second buffer window to display a connection status message in your host UI before the session enters full offline mode.
  </Card>

  <Card title="Keep Recording During Network Loss" icon="microphone">
    Let the SDK continue capturing audio locally when the network drops. Do not treat a brief disconnect as a failed ambient session.
  </Card>

  <Card title="Expect Paused Submission Until Reconnect" icon="cloud-arrow-up">
    Treat offline sessions as not yet submittable. The SDK pauses submission and retries upload and note submit after connectivity returns.
  </Card>

  <Card title="Plan for Slower Note Generation After Offline" icon="clock">
    After reconnect, expect longer note generation because the full audio must upload first. Keep your note-submission handlers ready for delayed delivery.
  </Card>
</CardGroup>

## What triggers offline mode

A session enters offline mode due to:

* Network interruptions
* Backend unavailability
* High latency in audio transmission
* Socket connection drops
* Authentication failures

## Offline mode behavior

When the session enters offline mode, the SDK automatically:

<CardGroup cols={2}>
  <Card title="Continues Recording" icon="microphone">
    Audio recording continues without interruption during network issues.
  </Card>

  <Card title="Local Storage" icon="hard-drive">
    Audio and metadata are stored locally on the device.
  </Card>

  <Card title="Automatic Upload" icon="cloud-arrow-up">
    Stored data is automatically uploaded once connection is restored.
  </Card>

  <Card title="User Notification" icon="bell">
    Users are notified about offline status and reconnection attempts.
  </Card>
</CardGroup>

<Info>
  During offline mode, **session submission is temporarily paused**. The SDK will continuously attempt to reconnect and submit the note once connectivity is reestablished.
</Info>

## Next steps

<Icon icon="file-lines" iconType="solid" /> Re-ambient and recovery: [Session recovery](/web-sdk/guides/ambient-session-recovery)

<Icon icon="file-lines" iconType="solid" /> Multilingual: [Multilingual support](/web-sdk/guides/ambient-multilingual)

<Icon icon="file-lines" iconType="solid" /> Return to [Ambient session](/web-sdk/guides/ambient) overview