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

# Sessions

> Sessions allow you to create scheduled events where staff can claim roles to faciliate the event.

<Info>
  For workspaces that prefer to automate session tracking, you can use our [sessions API](/api-reference/endpoint/sessions/get-all-upcoming-sessions)!
</Info>

Sessions turn your events — trainings, raids, shifts, patrols, tryouts — into
organized, claimable operations. Staff sign up for the roles they'll run and
everyone sees who's covering what. Recurring events build themselves on a
schedule, session servers link to your live Roblox games, and a Discord event can
fire automatically the moment a session is claimed.

## Session Calendar

The calendar allows you to view scheduled sessions. You can also create one-time sessions. Sessions are color-coded based on their occurrence. If it has already ended it is red, if it is in-progress it is green, if it is about to start it is yellow, and if it hasn't occurred yet it is grey. The calendar displays in your local-time zone.

<img src="https://mintcdn.com/readmin/X6aUMb9MDRkgjA7J/images/sessions.png?fit=max&auto=format&n=X6aUMb9MDRkgjA7J&q=85&s=b82aad00550d4cfa0fbe7e64763845a8" alt="Session Calendar" width="2292" height="1186" data-path="images/sessions.png" />

## Session view

The session view page allows you to view sesison details, and manage information related to it. If it is a one-off session you will have a special tab that will allow you to delete the session.

### Claims

Session claims allow you to claim a role, and see users who have already taken a role. You can also click into the [users](/features/user) page, or optionally remove the claim.

<img src="https://mintcdn.com/readmin/E3q2oHNta8NF-_mC/images/session-claiming.png?fit=max&auto=format&n=E3q2oHNta8NF-_mC&q=85&s=a3025ddd3171a8f2a7ad7d6af2577a70" alt="Session Claims" width="2312" height="1662" data-path="images/session-claiming.png" />

### Servers

To allow users to claim a session, you must first have a server they are in. You can create as many servers as you would like, and you can also link a session server to a running Roblox server that has the ReAdmin module. You can also assign servers a nickname to make it easier to recognize.

### Comments

Session comments allow you to leave comments or notes on the session.

<img src="https://mintcdn.com/readmin/E3q2oHNta8NF-_mC/images/session-comments.png?fit=max&auto=format&n=E3q2oHNta8NF-_mC&q=85&s=06bc0f464e0dda62b74534f1e4e49549" alt="Session Comments" width="2330" height="638" data-path="images/session-comments.png" />

## Session Template Schedule

The session template schedule allows you to view or create a schedule for a session template. This allows you to create a session template that will automatically create sessions based on the schedule you set. It is worth noting that **a session is not created until it is claimed by a user.**

<img src="https://mintcdn.com/readmin/X6aUMb9MDRkgjA7J/images/session-schedule.png?fit=max&auto=format&n=X6aUMb9MDRkgjA7J&q=85&s=7fd124dc9d8a119b37372f17481dbb3b" alt="Session Schedule" width="2346" height="1232" data-path="images/session-schedule.png" />

A template controls everything about how its recurring sessions are generated:

* Daily or weekly repeat patterns.
* Time, day, and game selection.
* Role-group assignment for claimable session roles.
* Notification lead time before a session starts.
* Optional Discord event creation.

You can create templates from the schedule page, then edit or remove them at any time — each one acts as the operational base for every session it generates.

### Creating a new session

<img src="https://mintcdn.com/readmin/F-gR_IUVwejEXgQL/images/session-ctemplate.png?fit=max&auto=format&n=F-gR_IUVwejEXgQL&q=85&s=220ec1fc35f3bbd8f8f77f0728dc5129" alt="Session Create Template" width="1152" height="1664" data-path="images/session-ctemplate.png" />

*If you have installed the ReAdmin Discord bot then you can optionally create an event in your Discord once the session has been claimed.*

<img src="https://mintcdn.com/readmin/VJ9bDjFu12zHRV_q/images/discord-event.png?fit=max&auto=format&n=VJ9bDjFu12zHRV_q&q=85&s=9a5e201e0095597c2ca38bb7976cd48a" alt="Session Discord Event" width="1260" height="1234" data-path="images/discord-event.png" />

## Session Role Groups

Role groups are the basis of sessions. They are the roles you create that users can claim in sessions — define them once, with their own requirements and limits, and reuse them across all your session templates.

<img src="https://mintcdn.com/readmin/E3q2oHNta8NF-_mC/images/role-groups.png?fit=max&auto=format&n=E3q2oHNta8NF-_mC&q=85&s=ceff1fe00e7805b5394bc14213ff0ee7" alt="Session Roles" width="2824" height="1042" data-path="images/role-groups.png" />

When building a role group you can:

* Create role groups for different session staffing models.
* Add sub-roles with individual constraints.
* Configure a per-role maximum number of users.
* Set minimum Roblox rank requirements.
* Enable claim-once behavior for non-admin users.

These requirements are enforced every time a session is claimed or re-claimed, so the right people always run the right roles.
