> ## 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.

## Recording controls in the live room

For manual recording, a host or moderator opens **More** in the bottom control bar and selects **Start recording**. The same menu provides **Stop recording** while a recording is active.

The room header identifies the current recording state and source. If a whiteboard is open when recording begins, Classroom requires an active screen share so the board is visibly included. The presenter chooses the correct browser tab, window, or screen before capture begins.

## 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.

| Displayed state | Meaning | Recommended action |
| - | - | - |
| Preparing | Classroom accepted the request and is starting capture | Keep the live room open and wait for Recording |
| Recording | Camera/audio or the active shared screen is being captured | Continue the class or select Stop recording when finished |
| Processing | Capture stopped and the video is being prepared | Wait; playback is not ready yet |
| Ready | The video can be previewed and managed | Preview, then publish if participants should see it |
| Failed | Classroom could not complete the recording | Review the event state and try a new recording only when appropriate |

## 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.

## Recordings after the event

Open the event details page and find **Recordings**. Each recording identifies its numbered segment and associated live session.

| Manager action | Result |
| - | - |
| Preview | Plays a ready recording without publishing it to ordinary participants |
| Publish | Makes the ready recording available to users who can view the event |
| Unpublish | Hides it from ordinary event viewers without deleting it |
| Delete | Permanently removes the video after confirmation while preserving its deleted history state |

The session timeline also shows recordings belonging to each live run. Students see only published ready recordings.

## 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.


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