# Offline Mode for Store OS

Offline Mode in **Store OS** allows stores to continue billing and completing sales even when internet connectivity is unavailable. The system securely uses last-synced data and automatically syncs all offline activity once the store is back online.
Offline Mode can be used in two scenarios:

1. **Manual Activation** – A sales associate can proactively switch the store to **Offline Mode** from Settings.
2. **Automatic Activation** – Store OS automatically switches to Offline Mode if network connectivity is lost.


During offline mode, a green banner at the top of the screen clearly indicates:

*"You’re in Offline Mode. You can continue billing, data will be synced once you’re back online."*

Before Offline Mode can be enabled, data **must be synced successfully**. If data is not synced, Offline Mode cannot be turned ON. Product catalog, inventory availability, payment modes and staff (sales employee) details are synced automatically.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/1.jpg)

center
em
Figure 1: Data Syncing
br
Offline Mode is not supported in Safari.
To access Offline Mode and continue selling without internet, please switch to Google Chrome or another supported browser.

## **How to Enable Offline Mode Manually**

1. Go to **Settings → Network Connectivity**
2. Toggle **Offline Mode** ON


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/3.jpg)

center
em
Figure 2: Toggle On Offline Mode
br
1. **Grant folder permission** when prompted:
  1. Select a folder path where Store OS can store offline data
  2. Allow browser permission to read/write files in this folder
  3. This is a **mandatory one-time step** for Offline Mode


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/4.jpg)

center
em
Figure 3: Grant folder permission
br
## **Visual Indicators in Offline Mode**

### **Offline Banner States**

Store OS shows different banners based on connectivity and sync state:

* **Blue Banner**: Internet is not connected
  * Indicates loss of network
  * Offline Mode is active automatically
  * **Turn Off CTA is NOT visible**


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/16.jpg)

center
em
Figure 4: Blue Banner 
br
* **Green Banner**: Offline Mode is enabled with data available
  * Indicates offline billing is active
  * Shows message that data will sync once back online
  * **Turn Off CTA is visible** when internet is available


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/6.jpg)

center
em
Figure 5: Green Banner 
br
### **To turn OFF Offline Mode, either:**

* Click **Turn Off** from the green banner, or
* Toggle **Offline Mode** OFF from Settings


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/13-hVU2X7XdN.jpg)

center
em
Figure 6: Toggle Off Offline Mode  
br
## **What You Can Do in Offline Mode**

### **1. Product & Cart Actions**

* Browse products using last-synced catalog
* Add products to cart
* Select size and quantity (based on last-synced inventory)


Inventory shown may not reflect real-time stock until sync completes.

### **2. Shipping & Fulfillment**

* **Only Self Pickup is allowed**
* Delivery and other shipping options are disabled


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/7.jpg)

center
em
Figure 7: Fulfillment Option in Offline Mode
br
### **3. Customer & Staff Details**

* Add or edit customer details
* Add a sales employee to the order
* Add order notes (e.g., gift wrap, special instructions)


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/8.jpg)

center
em
Figure 8: Customer & Staff Details 
br
### **4. Payments (Offline Payments Only)**

Only **offline payment modes** are available:

* Cash at Store
* Card Swipe at Store
* UPI at Store (offline confirmation)


Online payment methods are not available.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/9.jpg)

center
em
Figure 9: Payment Option in Offline Mode 
br
### **5. Completing the Sale**

* Orders can be successfully completed
* Invoice option is available. An **offline** label is shown at the top of the invoice
![](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/11.jpg)
Figure 10: Invoice in Offline Mode

* In **Orders List**, offline orders are visible immediately even before sync


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/12.jpg)

center
em
Figure 11: Orders List 
br
Each completed order is clearly marked as an **Offline Order**.

Offline invoices are valid and automatically reconciled once the order syncs online

## **What Is NOT Allowed in Offline Mode**

The following actions are disabled in offline mode:

* Promotions & coupons
* Delivery orders
* Product updates or extensions
* Online payment methods
* Real-time inventory updates
* Retrieving customer details using a scanner


These features automatically become available once the store is back online.

## **Syncing Back Online**

When internet connectivity is restored:

1. Store OS automatically switches back to Online Mode
2. A toast notification confirms: *"Order syncing started in background"*


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/Screenshot_2026-01-20_at_11.54.49%C3%A2%C2%80%C2%AFAM-vP634vDn8.png)

center
em
Figure 12: Order Syncing 
br
1. Offline orders begin syncing automatically
2. Once sync is complete, orders behave exactly like online orders


Order sync to OMS may take time based on volume and network. Users should wait until sync completes.

1. If syncing fails, orders remain in pending state and manual action is required. If Auto-Sync is OFF, users can manually trigger sync from **Settings → Network Connectivity**


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/14.jpg)

center
em
Figure 13: Manual Auto-Sync 
br
## **Offline Sessions Dashboard**

From **Settings → Network Connectivity**, users can view **All Offline Sessions**, including:

* Session ID
* Status (Success / Failed)
* Start date & time
* End date & time
* User who triggered Offline Mode
* Number of orders placed during the session


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/15.jpg)

center
em
Figure 14: All Offline Sessions 
br
* Offline sessions can be **exported** for audits or reconciliation
* Filters can be applied using date range and status


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/StoreOS/offline/15-z-JsmDu7Q.jpg)

center
em
Figure 15: Filter and Export Options 
br