# Holiday

<p class="doc-lead">Holiday records public holidays and company holidays. Holidays are applied to attendance automatically and can be scoped to all employees, a specific employee, or a department.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/hr/holiday?id=overview">Overview &amp; List View</a>
<a href="#/hr/holiday?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/hr/holiday?id=header-fields">Header Fields</a>
<a href="#/hr/holiday?id=calendar-view">Calendar View</a>
<a href="#/hr/holiday?id=actions">Actions &amp; Status</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/hr/holiday?id=faq">FAQ</a>
<a href="#/hr/holiday?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

<img src="hr/images/holidays.webp" alt="Holiday list" loading="lazy">

<b>Quick filters</b>

| **Filter** | **Description** |
|------------|-----------------|
| Suspended | Show suspended holidays only. |

<b>Advanced filters</b>

Id, Holiday range, Employee, Pay classification, Created date.

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Id | Record ID. |
| Name | Holiday name. |
| From Date | Start date. |
| To Date | End date (for multi-day holidays). |
| Pay classification | Salaried or Labour (Variable Shift). |
| Employee | Specific employee (if scoped). |
| Department | Specific department (if scoped). |
| Notes | Notes. |

<b>List row actions</b>

| **Action** | **Available when** |
|------------|-------------------|
| Edit | All |
| Delete | All |
| Suspend | Active |
| Activate | Suspended |
| View | All |

<b>Primary toolbar</b>

| **Action** | **Description** |
|------------|-----------------|
| Calendar view | Switch to calendar view. |
| New | Create a new holiday. |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

<h3>1. Navigate</h3>
Go to <b>HRMS → Masters → Holiday</b>.

<h3>2. Create new holiday</h3>
Click <b>New</b>.

<img src="hr/images/new-holiday.webp" alt="New Holiday" loading="lazy">

<h3>3. Fill in details</h3>
<ul>
<li>Enter <b>Name</b>, <b>From Date</b>, and optionally <b>To Date</b>.</li>
<li>Check <b>Recurs yearly</b> for annual holidays.</li>
<li>Select <b>Pay classification</b> if the holiday applies to one classification only.</li>
<li>Optionally scope to a specific <b>Employee</b> or <b>Department</b>.</li>
</ul>

<h3>4. Save</h3>
Click <b>Save</b>.

<hr class="doc-section-divider">

<h2 id="header-fields">Header Fields Reference</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Name * | Holiday name (e.g. National Day, Company Anniversary). |
| From Date * | First day of the holiday. |
| To Date | Last day (for multi-day holidays). Leave blank for single-day holidays. |
| Recurs yearly | Check if this holiday repeats every year on the same date. |
| Pay classification | <b>Salaried</b> or <b>Labour (Variable Shift)</b>. Leave blank to apply to all. |
| Employee | Apply only to this employee. |
| Department | Apply only to employees in this department. |
| Notes | Additional notes. |

<hr class="doc-section-divider">

<h2 id="calendar-view">Calendar View</h2>

Switch to calendar view from the list toolbar using <b>Calendar view</b>. Holidays appear as events on the calendar. Click an event to view, edit, suspend, activate, or delete.

Toolbar: <b>List View</b> (return to list), <b>New</b> (create holiday).

<hr class="doc-section-divider">

<h2 id="actions">Actions &amp; Status</h2>

| **Action** | **Description** |
|------------|-----------------|
| Edit | Opens for editing. |
| Delete | Permanently removes the holiday. |
| Suspend | Deactivates the holiday. |
| Activate | Reactivates a suspended holiday. |
| Print | Prints details. |

| **Status** | **Description** |
|------------|-----------------|
| Active | Holiday is applied to attendance. |
| Suspended | Holiday is ignored. |

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Do holidays automatically mark attendance?</b><br>
Yes. When attendance is generated, dates matching active holidays are marked with Holiday status.

<b>Can a holiday apply to only one department?</b><br>
Yes. Select the <b>Department</b> on the holiday record. Only employees in that department receive the holiday.

<b>What does Recurs yearly do?</b><br>
The holiday is automatically applied on the same date each year without creating a new record.

<b>How are holidays different from weekly off?</b><br>
Weekly off is configured once in <a href="#/hr/hrms-settings">HR Settings</a> for fixed weekdays. Holidays are date-specific events (public holidays, company closures).

<b>Do I need to regenerate attendance after adding a holiday?</b><br>
Yes for dates already generated — run Generate Attendance again or edit the day row so status shows Holiday.

<b>Can I create a half-day holiday?</b><br>
Use attendance status and notes on the specific date if policy allows partial holiday — the holiday master marks the full calendar date as holiday when generated.

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/hr/daily-attendance">Daily Attendance</a> — Holiday status on attendance grid.</li>
<li><a href="#/hr/hrms-settings">HR Settings</a> — weekly off days configuration.</li>
<li><a href="#/hr/reports/daily-attendance-report">Daily Attendance Report</a> — holiday count in summary.</li>
</ul>
