Skip to main content

Holiday Calendars

Holiday Calendars are shared sets of dates referenced by Access Control rules. On a date that appears in an assigned calendar, the rule will not grant access — regardless of its day/hour schedule.

The point of a calendar is to maintain holidays and shutdowns in one place and reference them from many rules, instead of duplicating per-rule exception lists.

Overview​

A holiday calendar contains:

  • A name (lowercase identifier) and label (human-readable)
  • A list of date entries — either a single date (2026-12-25) or a date range (from–to, inclusive on both ends)

Multiple access control rules can reference the same calendar.

Creating a Calendar​

  1. Open Security > Holiday Calendars
  2. Click Add
  3. Fill in name + label
  4. Add individual dates and/or date ranges
  5. Save

Examples​

US Federal Holidays

Name: us_federal_holidays
Label: US Federal Holidays
Dates: 2026-01-01, 2026-01-19, 2026-02-16, 2026-05-25, …

Office Shutdown

Name: office_shutdown
Label: Office Year-End Shutdown
Dates: { from: 2026-12-24, to: 2027-01-02 }

Using a Calendar​

In an access control rule's Schedule Configuration > Holiday Calendar dropdown, select the calendar to apply.

  • A calendar match wins over the rule's day/hour mask — if today is in the calendar, access is denied even if the day/hour would otherwise allow it
  • The rule's per-rule Schedule Exceptions list is still honored alongside the calendar (denied if either matches)

Managing Calendars​

  • Edit a calendar to add or remove dates — changes take effect immediately for all rules referencing it
  • Deleting a calendar leaves rules pointing at null — they fall back to per-rule exceptions only
  • A calendar with no dates blocks no days
  • Access Control — referencing holiday calendars from rules
  • Site Modes — for whole-site state changes (closed, vacation, etc.) that affect more than just access control