Skip to content

Holiday calendars

Holiday calendars let you define non-working days so that rotations skip holidays and alerts route correctly during those periods.

Creating a holiday calendar

  1. Navigate to On-call > Holiday Calendars and click Create Calendar.
  2. Name the calendar (e.g., Brazil National Holidays 2026).
  3. Add individual dates or import a list.

Each entry in the calendar has a date and an optional label (e.g., Independence Day).

Importing holidays

You can import holidays in CSV format:

csv
date,label
2026-01-01,New Year's Day
2026-04-21,Tiradentes
2026-05-01,Labor Day

This is useful for national or regional holiday lists that are shared across multiple schedules.

TIP

Create one calendar per country or region and share it across all relevant schedules. This avoids duplicating entries when multiple teams observe the same holidays.

Attaching a calendar to a schedule

On the schedule detail page, go to the Holidays tab and link one or more holiday calendars. When a rotation handoff falls on a holiday:

  • The rotation period is extended to skip the holiday.
  • The next participant's start date shifts accordingly.

For example, if a weekly rotation hands off on a Monday that is a holiday, the current responder stays on call through the holiday and the handoff occurs on Tuesday instead.

INFO

This behavior is called auto-skip and it applies to all rotation layers in the schedule.

Overlapping holidays

If multiple calendars are attached and a date appears in more than one, it is still treated as a single holiday. There is no double-skip.

Disabling auto-skip

If your team provides on-call coverage even on holidays, disable the Auto-skip holidays toggle on the schedule. The rotation proceeds as normal regardless of the holiday calendar.

WARNING

When auto-skip is disabled, responders assigned to a holiday shift will still receive alerts. Make sure those responders are aware of their assignment or set up an override to swap in a volunteer.

Combining with business hours

Holiday calendars complement business hours configuration. On a holiday, the day is treated as outside the business-hours window, so the after-hours behavior applies automatically.

Built by the Batida team