> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/admin-guide/domain-settings/holidays.md).

# Holidays

### Overview

MangoApps allows administrators to add holidays and important dates for different office locations, ensuring they are displayed on employees' calendars. A notification automatically appears under the bell icon a day before the scheduled company holiday or important date.

<img src="/files/pkjO1tMDefzxn7ql3qna" alt="" width="563">

***

### Managing Holidays and Important Dates

#### Locations and Years

Use the **Locations** and **Year** drop-downs to filter holidays and important dates based on office locations.

<figure><img src="/files/RixxdNvdvSniFlbb8Li0" alt="" width="563"><figcaption></figcaption></figure>

Countries will appear in the drop-down menu only if they have holidays listed in the table already.

***

#### List of Holidays

The list displays all holidays and important dates added to your domain for all office locations.&#x20;

{% hint style="warning" %}
A user’s office location determines the holidays displayed in their calendar.
{% endhint %}

**Holiday Details**

Each entry in the list includes:

* **Title**: The name of the company holiday/important event, used in notifications and calendar labels.
* **Type**: Two types are available:
  * **Company Holiday**: Dates when the office is closed for business.
  * **Important Date**: Significant events in a country that may not necessarily be office holidays.
* **Date**: The date of the company holiday/important event.
* **Description**: Additional details (up to 500 characters).
* **Location**: The specific office locations where the holiday applies.

***

### Adding a Company Holiday or Important Date

To add a holiday, click the **Add New Holiday** button located at the top right hand side of the screen.

<figure><img src="/files/bRwhHNXS7ll8A66RsUJM" alt="" width="563"><figcaption></figcaption></figure>

This will bring up the **Add New Holiday** menu.

<figure><img src="/files/Y4erYIaO7yaZv09HPSpG" alt="" width="427"><figcaption></figcaption></figure>

Within this menu:

* Select the **Type** (Company Holiday or Important Date).
* Enter a **Title** for the holiday. This Title will be displayed to applicable users on the configured date.
* Select the **Date**. Use the + Add End Date/Time option for multi-day holidays or specific time durations.
* Enter a **Description** (optional).
* Choose the **Country** or **Location** that observes this holiday (office locations where the holiday applies).

Click **Save**. The holiday or important date will now appear on the holiday list and to applicable users in the user portal.

<img src="/files/PYYz0F2SgszOjDgz4uT7" alt="" width="563">

***

### Using the Popular Holiday Finder

Alternatively to manually adding holidays, admins can use the Popular Holiday Finder menu to quickly find and add widely celebrated holidays for specific countries.

<figure><img src="/files/MMvB1CfDdzk1qTzk3im4" alt="" width="563"><figcaption></figcaption></figure>

Click the **Popular Holiday Finder** button located next to the **Add New Holiday Button** at the top of the screen. This will bring up the **Popular Holiday Finder** menu.

Select a **Country** and **Year** to fetch the holiday list.

Toggle holidays on/off as needed. Admins can click **Enable All** to add all holidays for the selected country at once. To remove holidays from the company holiday list, use the **Delete** option in the three-dot action menu next to each holiday in the selected company holiday list.

Click **Save** to finalize the holidays in the company holiday list.

{% hint style="info" %}
The MangoApps Holiday Finder utilizes the *Holidays* gem/library to retrieve holiday information. This integration functions on an on-demand basis, fetching holiday data only when requested. For instance, when an admin searches for holidays in a specific country or region, the system dynamically retrieves the relevant information.
{% endhint %}

***

### Editing, Cloning, and Deleting Holidays

Click the **three dots** menu next to a holiday to access additional options for a selected holiday.

<img src="/files/fkRUl9K2Zgeyg8cNMEcs" alt="" width="563">

Select **Edit**, **Clone**, or **Delete** as needed to manage the holidays list.

{% hint style="danger" %}
Only network admins can manage holidays and important dates.
{% endhint %}
