---
title: "Understanding Connection Status Alerts | Documentation"
description: "Learn what the connection status banner means and what to do when it appears while you're using Stokkd."
canonical_url: "https://website-staging.stokkd.com/docs/using-the-app/understanding-connection-status-alerts"
meta:
  "og:description": "Learn what the connection status banner means and what to do when it appears while you're using Stokkd."
  "og:image": "https://website-staging.stokkd.com/_og/d/c_Docs%2Ctitle_Understanding%2BConnection%2BStatus%2BAlerts%2Cdescription_Learn%2Bwhat%2Bthe%2Bconnection%2Bstatus%2Bbanner%2Bmeans%2Band%2Bwhat%2Bto%2Bdo%2Bwhen%2Bit%2Bappears%2Bwhile%2Byou're%2Busing%2BStokkd.%2Ccategory_Using%2Bthe%2BApp%2Cp_Ii9kb2NzL3VzaW5nLXRoZS1hcHAvdW5kZXJzdGFuZGluZy1jb25uZWN0aW9uLXN0YXR1cy1hbGVydHMi%2Cs_k2PLoUqolgFZHADR.png"
  "og:image:height": "630"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Understanding Connection Status Alerts"
---

> Index of every page on this site: [llms.txt](https://website-staging.stokkd.com/llms.txt)

## What Is the Connection Status Banner?

Stokkd continuously checks whether your device can actually reach the server — not just whether your device *thinks* it’s online. When that check fails, or your device is switching between WiFi and mobile data, a banner appears at the bottom of the screen.

This banner appears on every screen **except** the mobile scan page. While actively scanning, connection issues are shown differently — see [Connection Interruptions While Scanning](https://website-staging.stokkd.com/mobile-scan-connection-interruptions) for that behavior.

![ios - connection lost banner with retry button](https://fhwoiwukksaywmlerlge.supabase.co/storage/v1/render/image/public/support-files/articles/images/39e9de79/1787601245122-ios-connection-lost-banner.png?width=1200&quality=80&resize=contain "iOS - Connect Lost banner")

## Why It Matters

Checking real server reachability (rather than trusting your device’s WiFi indicator) means Stokkd can warn you even when your device *looks* connected but isn’t — for example, on a WiFi network that requires a login page, or one with no real internet access. Knowing what the banner means helps you decide whether to keep working or wait for it to clear.

## How It Works

The banner has two states:

- **Reconnecting (spinner icon):** Your device is switching networks or the app is re-verifying a connection. This is temporary and usually clears within a few seconds — no action needed.
- **Connection lost (icon +** `Retry` **button):** The app has confirmed there’s no usable connection. Some features may be unavailable until you reconnect. Once you have signal, tap `Retry` to trigger an immediate check.

When your connection is restored, a confirmation notification briefly appears near the top of the screen.

## Tips & Best Practices

- **Keep mobile data enabled as a fallback** on your phone or tablet — this allows a seamless handoff if WiFi drops.
- **Don’t rush during the spinner state** — the app is actively verifying the new connection and typically recovers on its own.
- **Use the** `Retry` **button rather than refreshing the page** — refreshing resets your active session context.

> **Having issues?** See the [Connection & Network Troubleshooting](https://website-staging.stokkd.com/connection-network-troubleshooting) guide for solutions to persistent banners, false positives, and platform-specific quirks.

### Was this article helpful?

## Sitemap

See the full [sitemap](https://website-staging.stokkd.com/sitemap.md) for all pages.