> For the complete documentation index, see [llms.txt](https://knowledge.maica.com.au/maica-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.maica.com.au/maica-knowledge-base/the-planner/planner-views-and-modes/roster-view.md).

# Roster View

## What information does the Roster View display?

The Roster View is an overview of all `Shift` and `Unavailability` information. 

{% hint style="info" %}
You have the option to display both unfilled `Shifts` and `Shifts` with allocated `Resource(s)`, as well as showing only `Resource(s)` with `Shifts` in Timeline Mode. To learn more, click [here](/maica-knowledge-base/the-planner/planner-filter.md). 
{% endhint %}

### Calendar Mode

On Calendar Mode, Roster View will display your Planner with the above information within a grid based on the days and hours of the [selected period](/maica-knowledge-base/the-planner/planner-views-and-modes.md#how-do-i-select-my-display-options-in-the-planner). 

<figure><img src="/files/oOarMB8jGttGnkKsma8N" alt=""><figcaption><p>Roster View on Calendar Mode</p></figcaption></figure>

{% hint style="info" %}
Please note that both the colour theming of the cells and the information presented within the cells are configurable. To learn more, click [here](/maica-knowledge-base/maica-administration-guide/settings/planner-management.md).&#x20;
{% endhint %}

### Timeline Mode

On Timeline Mode, Roster View will organise your Planner by `Resource(s)`. This will display all of the `Resource(s)` that have `Shifts` populated on the left , and all of their associated `Shifts` and `Unavailability` on the right.

<figure><img src="/files/21gO7LtzpAfJ9VTjKEFG" alt=""><figcaption></figcaption></figure>

When you make a Shift from Timeline Mode in Roster View, the Appointment will be pre-populated with the Resource of the row on which you created it.

{% hint style="info" %}
You can also display all Resource(s), not just those with allocated Shifts. To learn more, click [here](/maica-knowledge-base/the-planner/planner-filter.md).&#x20;
{% endhint %}

If you use the [`Group By`](/maica-knowledge-base/the-planner/planner-actions/group-by.md) Planner Action, **Maica** will show helpful indicators on your Planner to inform you of how many unique `Shifts(s)` you have at any given time, as shown below.&#x20;

<figure><img src="/files/IWqBVDxCo8tN2FPNM8nm" alt=""><figcaption></figcaption></figure>

Here, we have have grouped by `Location`, and **Maica** is showing us that during the three time slots we have 1 unique `Shift`.&#x20;

The colours of the numbers indicate the filled status of the Shift(s), as per below:&#x20;

* **Green**: Shifts filled with the required number of Resource(s).&#x20;
* **Yellow**: Shifts partially filled with the required number of Resource(s).&#x20;
* **Red**: Shifts not filled with the any Resource(s).&#x20;

{% hint style="info" %}
An unfilled Shift is any Shift that does not have the required number of Resources allocated.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledge.maica.com.au/maica-knowledge-base/the-planner/planner-views-and-modes/roster-view.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.