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

# Recording settings

> Choose when cameras record, how long footage stays, and whether customers can replay it.

Open **Recordings** with permission to manage recording settings. Review each camera's recording state and policy.

## Choose when to record

Use **Always** for continuous recording or **On a schedule** for specific windows. Review the camera's schedule and timezone before saving. A camera must have a working connection and recording storage to produce footage.

Turning recording on now does not create footage from before it was enabled.

## Choose how long footage stays

Two policies work together:

* **Camera storage limits** set how much history the camera can retain.
* **Visit-based retention and extra staff retention** determine which time ranges still need to be kept.

Under the recording policy, choose how long staff should retain footage after the associated access ends. Extra staff retention defaults to zero. Review it explicitly if the business needs time to investigate an issue after checkout.

Setting a long camera duration alone does not override visit-based cleanup. Footage also depends on available disk space; storage pressure can shorten retained history.

## Allow customer replay

Enable customer replay for the camera when appropriate, then choose how far back customers may go.

Customers can only replay footage within their own authorized visit, while their access remains active. Paused, expired, revoked, or ended access prevents customer replay. Extra staff retention does not extend customer access.

## Check storage estimates

Where available, Peeksee estimates storage from measured recordings. An estimate needs enough recent data from the gateway. Treat a missing or stale estimate as unknown capacity, and leave room for other files and recording variation.

## Verify your changes

After saving, allow the gateway to receive the settings and record some footage. Open the camera and check its timeline. Test customer replay separately with an eligible customer account.

See [Watch recordings](https://docs.peeksee.app/recordings/playback.md) if a time range is unavailable.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.