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

# Classroom Recordings

> Recording policies, capture sources, processing, publication, playback, deletion, and retention.

Classroom creates recordings for a live session and keeps completed videos private until a manager chooses to publish them. Once recording has started, it does not depend on the teacher keeping the recording controls open.

## Recording policies

Each event has one policy:

* **Disabled**: recording cannot start.
* **Manual**: a host or moderator starts and stops recording in the live room.
* **Automatic**: recording is requested when a live session starts.

School operational policy can additionally require users to acknowledge a versioned recording notice before joining any recordable event.

## What is recorded

Classroom supports two recording sources:

### Camera grid

When no screen presentation is active, the recording uses the published camera and audio tracks. A participant with their camera off may not appear as a visible tile in the finished video even if the live room shows their placeholder.

### Shared screen

When screen sharing is active, the shared screen becomes the main content in the recording. The presenter chooses the screen, window, or browser tab using the browser's sharing menu.

A whiteboard shown with **Present board** is not included automatically in the video. To record it, share the browser tab or screen containing the board before starting the recording. Stopping the recording does not stop the screen share.

## Start and stop lifecycle

Manual recording moves through a short sequence:

1. **Preparing** while Classroom starts the recording;
2. **Recording** while the live room is being captured;
3. **Processing** after the recording is stopped;
4. **Ready** when the video can be previewed or published.

The normal states are:

`preparing → recording → processing → ready`

The video is not available immediately after clicking stop. Processing time depends on the recording length. A recording that cannot be completed is marked **Failed** so a manager can distinguish it from one that is still processing.

## Separate recording segments

Stopping and then starting again creates another numbered recording for the same session. It does not append to the first MP4. A new segment can start while an earlier segment is still processing, provided school recording quotas allow it.

## Publication and visibility

Ready recordings are private by default. Event managers can preview them, then publish or unpublish them. Ordinary event viewers discover and play only published recordings. This prevents every completed recording from becoming student-visible automatically.

Recordings play in the built-in video viewer. Fullscreen and download availability depend on the user's browser and the actions allowed on the recording.

## Delete and retention

Managers can delete a recording after confirmation. Its deleted state remains visible in the event history.

If the school configures recording retention, recordings older than that period are deleted automatically. School storage or simultaneous-recording limits can prevent a new recording from starting until capacity is available.