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

# Holidays

> This guide explains **how to configure holidays in Yardo**. Holidays are used to mark full-day closures that override a location’s normal operating hours.

Holidays provide a simple, explicit way to prevent scheduling on days when a facility is closed.

***

## What Is a Holiday

A **Holiday** represents a full-day closure for a location.

When a holiday is configured:

* The location is treated as closed for the entire day
* Normal operating hours are overridden
* New appointments cannot be scheduled on that date

Holidays are evaluated before other scheduling rules such as dock capacity or maintenance windows.

***

## How Holidays Fit into Scheduling

Holidays apply at the **location level** and affect all docks, zones, and equipment at that facility.

Scheduling precedence is evaluated in the following order:

1. Holidays (full-day closures)
2. Location operating hours
3. Maintenance windows
4. Zone, dock, and equipment constraints

This ensures that no appointments can be created on a holiday, regardless of other configuration.

***

## How to Add a Holiday

Only administrators can manage holidays.

**To add a holiday:**

1. Navigate to **Holidays** for a location
2. Enter a holiday name
3. Select the date
4. (Optional) Enable **Annual holiday**
5. Click **Add holiday**

Once added, the holiday immediately blocks scheduling for that date.

***

## Annual Holidays

Annual holidays repeat every year on the same month and day.

Use annual holidays for:

* Public holidays (e.g. Christmas, New Year’s Day)
* Company-wide closures

When enabled, Yardo automatically applies the holiday each year without requiring reconfiguration.

***

## Time Zone Behavior

Holidays are evaluated using the **location’s time zone**.

<Info>
  Holiday dates are treated as full, location-local days regardless of user time zone.
</Info>

This ensures consistent behavior for all users scheduling at the facility.

***

## Viewing and Managing Holidays

Configured holidays are listed chronologically and can be filtered by year.

Administrators can:

* Edit an existing holiday
* Delete a holiday

Changes take effect immediately and may impact future scheduling.

***

## Holidays vs Maintenance Windows

While both holidays and maintenance affect availability, they serve different purposes:

* **Holidays** – Full-day closures that override operating hours
* **Maintenance windows** – Time-bound downtime that may apply to a location, zone, or door

Use holidays for predictable, full-day closures and maintenance windows for partial or scoped downtime.

***

## Best Practices

* Use annual holidays for recurring public or company-wide closures
* Avoid using maintenance windows for full-day closures
* Review holidays annually to ensure accuracy
* Communicate holiday closures to carriers in advance

***

## Summary

Holidays provide a clear and reliable way to block scheduling on closed days.

By configuring holidays at the location level, organizations ensure that appointment availability accurately reflects real-world operating calendars.