Photo Uploads & Offline Queue

Photos taken during appointments upload to secure cloud storage automatically. If your connection drops mid-upload, photos are saved locally and retry automatically when you're back online.

---

Taking Photos During an Appointment

1. Open the appointment
2. Go to the Photos step (or the Photos section)
3. Tap Add Photo to take a photo or select from your gallery
4. The photo appears immediately as a preview while it uploads in the background

You can continue working on the appointment while photos upload — no need to wait.

---

What Happens When You Lose Connection

If a photo upload fails because of a network issue, timeout, or server error:

1. The photo is saved to your device's local storage (IndexedDB)
2. A floating badge appears showing how many photos are queued
3. When your connection returns, uploads resume automatically with exponential backoff
4. Each photo retries up to several times before pausing

You do not lose any photos. They stay safely on your device until the upload succeeds.

---

The Upload Queue Indicator

A small floating badge appears in the corner of your screen when photos are queued. It shows:

| Indicator | Meaning | |-----------|---------| | Offline icon | Your device is currently offline | | Number badge | How many photos are waiting to upload | | Progress bar | Current upload in progress | | Retry button | Tap to manually trigger a retry |

The badge disappears once all queued photos have uploaded successfully.

---

Completing an Appointment With Pending Uploads

You can complete a treatment step even if some photos are still uploading. Only photos that have finished uploading are attached to the appointment record. Queued photos will attach once their upload completes.

---

What About Crashes?

If the app closes unexpectedly (browser crash, phone restart), queued photos are not lost. When you reopen the app:

• Photos stuck in an "uploading" state are reset to "queued"
• They retry automatically on next connection

---

Non-Retryable Errors

Some upload failures are permanent and won't keep retrying:

| Error | What happens | |-------|-------------| | File too large (413) | Photo removed from queue — resize and re-upload | | Bad file format (400) | Photo removed from queue — use a supported format (JPG, PNG, HEIC) | | Auth expired (401/403) | Photo stays in queue — you'll be asked to log in again |

---

Deleting a Photo

If you delete a photo from an appointment, it's also removed from the upload queue — so you won't get a surprise upload of a photo you already removed.

---

Related Guides

• Photos & Documentation
• Appointment Notes
• Batch Tracking

---

Need help? support@aestheti.cc