> For the complete documentation index, see [llms.txt](https://docs.spike.sh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spike.sh/oncall-schedules/introduction-to-layers-in-on-call-schedules.md).

# Layers in on-call schedules

Each on-call schedule can have one or more layers. Every layer has its own members, rotation, handoff times, and slots. When two layers overlap, the higher-numbered layer takes over.

## Example: weekday and weekend coverage

This example has two layers:

* **Layer 1:** Daily rotation among 2 members, covering all days
* **Layer 2:** One person on-call each weekend, rotating weekly from Friday 6 PM to Monday 9 AM

Layer 1 is the base. One of the two members is on-call every day of the week.

<figure><img src="/files/4z7yVtq1Y0FJ5j4KfjVk" alt="Single layer on-call schedule with daily rotation"><figcaption><p>Layer 1: daily rotation among 2 members.</p></figcaption></figure>

<figure><img src="/files/tKs2T62IMa6jhtr6Gy7Z" alt="Calendar view of a single-layer on-call schedule"><figcaption><p>Calendar view with Layer 1 only.</p></figcaption></figure>

Layer 2 covers weekends only. It runs from Friday 6 PM to Monday 9 AM with a weekly rotation.

<figure><img src="/files/ZILbrzMqLAishWQwb8FW" alt="Layer 2 on-call schedule for weekend coverage"><figcaption><p>Layer 2: weekend coverage from Friday 6 PM to Monday 9 AM.</p></figcaption></figure>

<figure><img src="/files/PI1pPNx5eIWktYzo3ve5" alt="Calendar view with two layers showing weekday and weekend coverage"><figcaption><p>Calendar with both layers: weekday and weekend coverage.</p></figcaption></figure>

Layer 2 was added so the members rotating on Layer 1 get a break over the weekend. Layer 2 overrides Layer 1 from Friday 6 PM to Monday 9 AM.

## How layers work

Layers are ordered sequentially. When two layers share overlapping time windows, the higher layer overrides the lower one. If Layer 1 and Layer 2 overlap, Layer 2 is active during that window. In a three-layer schedule, Layer 3 overrides both Layer 1 and Layer 2 wherever they overlap.

{% hint style="info" %}
Layer order matters. If your weekend layer is Layer 1 and your weekday layer is Layer 2, the weekend layer will never take effect because Layer 2 always takes precedence. There is no limit on the number of layers in a single schedule.
{% endhint %}

## FAQs

### Can I add a layer temporarily?

Yes. You can also use [on-call overrides](/oncall-schedules/override-an-on-call.md) for short-term coverage changes.

### How many layers can I add?

There is no limit. That said, too many layers can make the schedule hard to follow.

### How many members can be added in one layer?

There is no limit.


---

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

```
GET https://docs.spike.sh/oncall-schedules/introduction-to-layers-in-on-call-schedules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.