Holiday Management - User Guide
Version: 1.0
Last updated: December 10, 2025
What is Holiday Management?
The Holiday Management system is where HR teams manage all company holidays and special days off. This system helps you:
- View all company holidays
- Add new holidays to the calendar
- Edit existing holidays
- Delete or deactivate holidays
- Set holiday types (regular or special)
- Add descriptions and details
- Enable or disable holidays
- Generate holiday calendars
- Plan around holidays for scheduling
Who Should Use This System?
This system is for:
- HR Managers — Create and manage company holidays
- HR Specialists — Assist with holiday management
- HR Directors — Oversee holiday policies
- Payroll Staff — Track holidays for salary calculations
- Finance Team — Monitor holiday-related expenses
- System Administrators — Maintain holiday records
How to Access Holiday Management
Method 1: From the HR Menu
- Log in to the DTR System
- Click on HR in the main menu
- Click on Holidays or Holiday Management
- You're now viewing the Holiday Management system
Method 2: Direct URL
URL: /hr/holidays
Holiday Management Overview
The Holiday Management system has four main pages:
Page 1: Holiday List (index.blade.php)
Shows all holidays with view, edit, and delete options.
Page 2: Create Holiday (create.blade.php)
Form to add a new holiday.
Page 3: Edit Holiday (edit.blade.php)
Form to modify an existing holiday.
Page 4: Holiday Details (show.blade.php)
Detailed view of a specific holiday.
Page 1: Holiday List
Overview
This is the main page showing all company holidays in a table format.
Page Layout
The page is organized into these sections:
Section 1: Header and Actions (Top)
- Page title "Holidays" or "Holiday Management"
- "Create Holiday" or "Add New Holiday" button
- Search or filter options
- Export button (if available)
Section 2: Holiday Table (Main Content)
- All holidays displayed in table format
- Multiple columns with information
- Action buttons for each holiday
- Color coding or icons for holiday type
Section 3: Pagination (Bottom)
- Navigation controls
- Page indicators
- Shows holidays 10 per page
- Previous/Next buttons
Understanding the Holiday Table
Column 1: Holiday Name
What it shows: Name of the holiday
Examples:
- Christmas Day
- New Year's Day
- Independence Day
- Thanksgiving
- Diwali
- Eid al-Fitr
- Lunar New Year
- Company Anniversary
Purpose: Identify the holiday
Example:
Christmas Day
New Year's Day
Independence Day
Column 2: Date
What it shows: When the holiday occurs
Format: Month Day, Year (e.g., December 25, 2025)
Purpose: Know exactly when the holiday is
Example:
December 25, 2025
January 1, 2026
July 4, 2025
Column 3: Type
What it shows: Category of the holiday
Type Options:
-
Regular Holiday (Green Tag)
- Standard company holiday
- Recurring annually
- Everyone gets the day off
- Full paid time off
-
Special Holiday (Orange/Purple Tag)
- Non-recurring special event
- Limited to specific year
- May not be annual
- Special circumstances
Example:
[Green Tag] Regular
[Orange Tag] Special
Purpose: Distinguish between recurring and one-time holidays
Column 4: Description
What it shows: Additional details about the holiday
Examples:
- "National Independence Day - Company closed"
- "Lunar New Year celebration - Office closed for 3 days"
- "Special company event - All staff invited"
- "Religious holiday - Flexible holiday"
Purpose: Understand why it's a holiday
Column 5: Status
What it shows: Whether the holiday is active or inactive
Status Options:
-
Active (Green Badge/Checkmark)
- Holiday is currently in effect
- Affects attendance and payroll
- Employees get the day off
-
Inactive (Gray Badge/X)
- Holiday is disabled
- No longer recognized
- Employees must work
- For archived or cancelled holidays
Example:
[Green] Active
[Gray] Inactive
Purpose: Enable or disable holidays as needed
Column 6: Created Date
What it shows: When the holiday was added to the system
Format: Date (Month Day, Year)
Example:
December 1, 2025
Purpose: Track when record was created
Column 7: Actions
What it shows: Buttons to manage the holiday
Action Buttons:
-
View/Details Button (Eye Icon)
- Click to see full holiday details
- Takes you to the details page
- View all information about the holiday
-
Edit Button (Pencil Icon)
- Click to modify holiday details
- Takes you to edit form
- Change date, name, type, or description
-
Delete Button (Trash Icon)
- Click to remove the holiday
- Asks for confirmation
- Permanently deletes from system
-
Toggle Status Button (Toggle/Switch)
- Click to activate/deactivate
- Changes status instantly
- No page reload needed
Purpose: Manage individual holidays
Page 2: Create Holiday
How to Access Create Page
Steps:
- From the Holiday List page
- Click the "Create Holiday" or "Add New Holiday" button
- Top right corner usually
- You're taken to the create holiday form
Create Holiday Form Layout
The form contains these fields:
Field 1: Holiday Name
What it is: The name of the holiday
Type: Text input field
Required: Yes (must fill)
How to fill:
- Click on the "Holiday Name" field
- Type the holiday name
- Use clear, descriptive names
Examples of Good Names:
Christmas Day
New Year's Day
Independence Day
Thanksgiving
Diwali
Eid al-Fitr
Lunar New Year
Examples of Names to Avoid:
Holiday (too vague)
X (not descriptive)
Company Event (use specific name)
Field 2: Date
What it is: When the holiday occurs
Type: Date picker field
Required: Yes (must fill)
Format: MM/DD/YYYY or your system's date format
How to fill:
- Click on the Date field
- A calendar picker appears
- Navigate to the correct month and year
- Click on the date
- Or type the date directly
Example:
12/25/2025 (December 25, 2025)
01/01/2026 (January 1, 2026)
07/04/2025 (July 4, 2025)
Tips:
- Use calendar picker for easier selection
- Ensure date is correct before saving
- Check for date conflicts with existing holidays
Field 3: Holiday Type
What it is: Category of the holiday
Type: Dropdown/Select field
Required: Yes (must select)
Options:
-
Regular — Recurring annual holiday
- Christmas, New Year, Thanksgiving, etc.
- Happens every year
- Standard company holiday
-
Special — One-time or non-recurring holiday
- Company anniversary celebration
- Special event year
- Unique holiday
- Limited to specific year
How to fill:
- Click on the "Holiday Type" dropdown
- Select either "Regular" or "Special"
- Options appear in the dropdown
Decision Guide:
- Is this holiday every year? → Select "Regular"
- Is this a one-time event? → Select "Special"
- Is it annual but optional? → Select "Regular"
- Is it year-specific? → Select "Special"
Example:
Christmas Day → Regular
Company 10th Anniversary → Special
New Year's Day → Regular
Special Event Holiday 2025 → Special
Field 4: Description
What it is: Additional details about the holiday
Type: Text area (large text field)
Required: No (optional)
How to fill:
- Click on the Description field
- Type any additional information
- Explain why it's a holiday
- Add special notes if needed
- Leave blank if not needed
Examples of Good Descriptions:
"National Independence Day - Company offices closed -
All employees get paid holiday"
"Lunar New Year celebration - Office closed for 3 days -
February 10-12, 2025"
"Religious holiday - Flexible day - Employees may request
this as personal observance"
"Company 5th Anniversary - Celebration event -
Early closure at 3 PM"
Tips:
- Be clear and concise
- Explain impact on employees
- Note any special arrangements
- Mention if flexible or mandatory
Field 5: Active Status
What it is: Whether the holiday is currently active
Type: Checkbox or toggle switch
Required: No (optional, defaults to active)
How to fill:
- If there's a checkbox, click to check/uncheck
- If there's a toggle, click to enable/disable
- Checked/On = Active
- Unchecked/Off = Inactive
When to Check:
- Check if holiday should be in effect
- Leave unchecked for archived holidays
- Usually checked when creating new holidays
Note: You can change this anytime after creation
Submit Button
What it does: Saves the new holiday
How to use:
- Fill all required fields (name, date, type)
- Fill optional fields if needed
- Click "Create Holiday" or "Save" button
- System validates the information
- If valid, holiday is created
- You're taken to details page or holiday list
- Success message appears
Cancel Button
What it does: Abandons the form without saving
How to use:
- Click "Cancel" button
- You're taken back to holiday list
- Nothing is saved
Page 3: Edit Holiday
How to Access Edit Page
Steps:
- From the Holiday List page
- Find the holiday you want to edit
- Click the pencil/edit icon
- You're taken to the edit holiday form
- All current information is pre-filled
Edit Holiday Form Layout
The form is similar to the create form with pre-filled values:
Editable Fields
-
Holiday Name
- Can be changed
- Edit text if needed
- Type the new name
-
Date
- Can be changed
- Click to use date picker
- Select new date if needed
-
Holiday Type
- Can be changed
- Dropdown shows current selection
- Click to change to different type
-
Description
- Can be changed
- Edit or clear text
- Add more details if needed
-
Active Status
- Can be changed
- Toggle to activate/deactivate
How to Edit a Holiday
Steps:
- Open the edit page for the holiday
- Identify what you want to change
- Click on that field
- Make the changes
- Review all changes
- Click "Update" or "Save" button
- System validates the changes
- If valid, holiday is updated
- Success message appears
Example: Change Christmas Date
Current: December 25, 2025
Want to change to: December 25, 2026
Steps:
- Click on the Date field
- Clear current date
- Select December 25, 2026
- Click Update
- Holiday date is changed
What You Can Edit
Can Edit:
- Holiday name
- Holiday date
- Holiday type (regular to special or vice versa)
- Description/details
- Active status
Cannot Edit:
- Created date (system generated)
- Holiday ID (unique identifier)
Update Button
What it does: Saves changes to the holiday
How to use:
- Make changes to fields
- Review all changes
- Click "Update" or "Save" button
- System validates changes
- If valid, holiday is updated
- Confirmation message shown
- You may stay on page or return to list
Page 4: Holiday Details
How to Access Details Page
Steps:
- From the Holiday List page
- Find the holiday you want to view
- Click the eye/view icon
- You're taken to the details page
- See all information about the holiday
Details Page Layout
The page shows all holiday information:
Section 1: Holiday Information (Top)
Shows:
- Holiday name (large heading)
- Holiday type (Regular or Special)
- Holiday date
- Active status (Active/Inactive)
- Created date
- Last updated date
Example:
╔═══════════════════════════════════╗
║ Christmas Day ║
║ Type: Regular ║
║ Date: December 25, 2025 ║
║ Status: Active ✓ ║
║ Created: December 1, 2025 ║
╚═══════════════════════════════════╝
Section 2: Holiday Details
Shows:
- Complete holiday information
- Description/notes
- Any special arrangements
- Impact on employees
Example:
Holiday Name: Christmas Day
Date: December 25, 2025
Type: Regular
Status: Active
Description: National Christmas holiday -
Company offices closed -
All employees get paid holiday
Section 3: Additional Information
Shows:
- When created
- Who created it (if available)
- Last modification date
- Who modified it (if available)
Section 4: Action Buttons (Bottom)
Shows:
- Edit button — Modify this holiday
- Delete button — Remove this holiday
- Back button — Return to list
- Deactivate/Activate button — Toggle status
Common Tasks in Holiday Management
Task 1: View All Holidays
Objective: See a list of all holidays
Steps:
- Open Holiday Management page
- You see all holidays in a table
- Scroll to see more
- Use pagination to view more holidays
- Each row shows holiday details
Task 2: Add a New Holiday
Objective: Create a new holiday in the system
Steps:
- Open Holiday Management page
- Click "Create Holiday" or "Add New Holiday" button
- Fill in the form:
- Enter holiday name (required)
- Select date (required)
- Choose type: Regular or Special (required)
- Add description (optional)
- Check Active status (usually checked)
- Click "Create Holiday" or "Save" button
- Holiday is created and saved
- You're taken to the details page
- Success message appears
Example: Add a New Company Holiday
Holiday: Company Founding Day
Date: March 15, 2026
Type: Regular (happens every year)
Description: Company Anniversary - Office closed
Steps:
- Click Create Holiday
- Name: "Company Founding Day"
- Date: 03/15/2026
- Type: Regular
- Description: "Company Anniversary - Office closed"
- Check Active
- Click Save
- Holiday created!
Task 3: Edit an Existing Holiday
Objective: Change holiday details
Steps:
- From Holiday List page
- Find the holiday to edit
- Click the edit/pencil icon
- Edit form opens with current information
- Change the fields you need
- Click "Update" or "Save"
- Holiday is updated
- Success message appears
Example: Change Holiday Date
Current: December 25, 2025
Need to Change: December 26, 2025 (observed date)
Steps:
- Click edit icon
- Click Date field
- Change to 12/26/2025
- Click Update
- Date is changed!
Task 4: View Holiday Details
Objective: See full information about a specific holiday
Steps:
- From Holiday List page
- Find the holiday to view
- Click the eye/view icon
- Details page opens
- See all holiday information
- Review description and details
- Click back when done
Task 5: Deactivate a Holiday
Objective: Disable a holiday (employees must work)
Scenario: Holiday was cancelled or moved
Steps:
- From Holiday List page
- Find the holiday to deactivate
- Click the toggle/switch button in the Status column
- Or open details page and click "Deactivate"
- Status changes to Inactive
- Holiday no longer recognized
- Employees must work that day
Task 6: Activate a Holiday
Objective: Enable a previously inactive holiday
Steps:
- From Holiday List page
- Find the inactive holiday
- Click the toggle/switch button in the Status column
- Status changes to Active
- Holiday is now recognized
- Employees get the day off
Task 7: Delete a Holiday
Objective: Remove a holiday completely from the system
Caution: This cannot be undone!
Steps:
- From Holiday List page
- Find the holiday to delete
- Click the trash/delete icon
- Confirmation dialog appears
- Click "Confirm" or "Yes" to delete
- Holiday is permanently removed
- Cannot be recovered
Better Alternative:
- Instead of deleting, deactivate the holiday
- This preserves the record
- Can be reactivated later
Task 8: Search for a Holiday
Objective: Find a specific holiday quickly
Steps:
- From Holiday List page
- If search box available, use it
- Type holiday name or partial name
- Results filter in real-time
- Or scroll through the list manually
- Use pagination to find holidays
Example:
- Type "Christmas" to find Christmas holidays
- Type "New Year" to find New Year holidays
- Type "2025" to find holidays in 2025
Task 9: Export Holiday List
Objective: Download holidays for external use
Steps:
- From Holiday List page
- Look for "Export" or "Download" button
- Click the button
- File download starts
- Open file in Excel or spreadsheet
- Share with teams or payroll
Task 10: Plan Annual Holidays
Objective: Set up all holidays for the year
Steps:
- Review company holiday calendar for the year
- List all company holidays
- For each holiday:
- Click Create Holiday
- Fill in details
- Set as Regular if annual
- Save
- Review complete list
- Share with employees
Understanding Holiday Types
Regular Holidays
What they are: Annual recurring holidays
Examples:
- New Year's Day (January 1)
- Independence Day (July 4)
- Thanksgiving (Fourth Thursday of November)
- Christmas (December 25)
- Diwali (October/November)
- Eid al-Fitr (Islamic calendar)
Characteristics:
- Happen every year
- Same date or predictable date
- All employees get the day off
- Paid time off
- Cannot be changed per employee
Impact on System:
- Employees get these days off automatically
- Appear on calendar every year
- Affect attendance calculations
- Payroll includes as paid holiday
When to Use Regular Type:
- Holidays that recur annually
- National or religious holidays
- Company standard holidays
- Expected and predictable
Special Holidays
What they are: Non-recurring or one-time holidays
Examples:
- Company 10th Anniversary (year-specific)
- Special event holiday
- Emergency closure (one day only)
- Optional holiday (year-specific)
- Flexible holiday (taken as personal choice)
Characteristics:
- May not happen every year
- Specific to certain year
- May have varying dates
- Limited to specific employees (optional)
- May be paid or unpaid
Impact on System:
- Only applies to specified year
- Does not repeat automatically
- Must be recreated if repeated
- Optional holidays tracked separately
When to Use Special Type:
- One-time events
- Year-specific holidays
- Non-recurring occasions
- Special company events
Status Explanation
Active Status
What it means: Holiday is currently in effect
Impact on System:
- Holiday is recognized
- Employees get the day off
- Affects attendance records
- Impacts payroll calculations
- Shows on calendar
When to Set Active:
- When creating new holidays
- When a holiday should be recognized
- When re-enabling a cancelled holiday
Inactive Status
What it means: Holiday is disabled
Impact on System:
- Holiday is not recognized
- Employees must work
- Does not affect attendance
- No payroll impact
- Does not show as holiday
When to Set Inactive:
- Holiday cancelled for year
- Holiday moved to different date
- Archiving old holidays
- Disabling optional holidays
Important Information About Holidays
Holiday Validation
When creating or editing holidays, the system checks:
- Holiday Name — Must not be empty
- Holiday Date — Must be valid date
- Holiday Type — Must be Regular or Special
- Duplicate Check — May check for duplicate dates
Holiday Impact on Other Systems
Calendar System
- Active holidays appear on HR Calendar
- Shown in red (holiday color)
- Calendar updates automatically
- Employees see their holidays
Attendance System
- Employees marked as holiday (not absent)
- Holidays excluded from absence count
- No attendance mark needed
- No deduction for holiday
Leave System
- Employees cannot take leave on active holidays
- Holiday days don't use leave balance
- System may block leave requests
- Holidays respected in planning
Payroll System
- Active holidays = Paid time off
- Salary includes holiday payment
- Payroll calculated correctly
- Benefits coverage maintained
Dashboard/Calendar
- Holiday count displayed
- Upcoming holidays shown
- Holiday list accessible
- Quick reference available
Tips for Effective Holiday Management
Tip 1: Plan Annually
- Add all holidays at start of year
- Review and confirm before year starts
- Avoid last-minute additions
- Allow time for communication
Tip 2: Include All Holiday Types
- National holidays
- Religious holidays
- Company-specific holidays
- Cultural holidays
- Regional holidays (if applicable)
Tip 3: Clear Descriptions
- Explain each holiday
- Note any special arrangements
- Mention office closure status
- Clarify if paid or unpaid
Tip 4: Use Correct Type
- Regular for annual holidays
- Special for one-time events
- Keep consistent
- Helps with reporting
Tip 5: Communicate Changes
- Announce new holidays early
- Notify of cancelled holidays
- Update calendar for employees
- Send calendar to all staff
Tip 6: Coordinate with Payroll
- Ensure payroll knows about holidays
- Confirm which are paid
- Check impact on salary
- Verify processing is correct
Tip 7: Consider Flexibility
- Some holidays may be flexible
- Employees may choose to observe
- Document in description
- Note in comments
Tip 8: Regular Review
- Review annually
- Update for legal changes
- Add new company holidays
- Remove obsolete holidays
Tip 9: Test Before Activation
- Test new holidays in system
- Verify calendar display
- Check payroll impact
- Confirm with affected teams
Tip 10: Keep Records
- Archive old holidays (deactivate)
- Keep holiday history
- Document changes
- Maintain audit trail
Common Questions
Q: What's the difference between Regular and Special holidays?
A:
- Regular: Annual recurring holidays (Christmas, New Year, etc.)
- Special: One-time or year-specific holidays (company anniversary, special events)
Q: Can I change a holiday after creating it?
A: Yes, click the edit icon and modify:
- Name
- Date
- Type
- Description
- Status
Q: What happens when I deactivate a holiday?
A:
- Holiday no longer recognized
- Employees must work that day
- No payroll holiday pay
- Attendance calculated normally
Q: Can I permanently delete a holiday?
A: Yes, click the delete icon, but:
- It cannot be recovered
- Better to deactivate instead
- Keep historical records
Q: Can employees see the holiday list?
A: Depends on system permissions:
- Usually yes, on calendar
- May not see management features
- Different access levels apply
Q: What if a holiday falls on weekend?
A: Depends on company policy:
- Some observe on nearest weekday
- Some don't pay for weekend holidays
- Some give day off in lieu
- Document in description
Q: Can I have multiple holidays on same date?
A: System may prevent duplicates:
- Check for conflicts
- Use descriptions to clarify
- Contact administrator if needed
- Keep accurate records
Q: How do holidays affect leave requests?
A:
- Employees cannot take leave on active holidays
- System may block leave requests
- Holidays don't use leave balance
- Calendar shows both clearly
Q: Can I make a holiday optional?
A: Use the Special type:
- Note in description "flexible" or "optional"
- Employees may choose to observe
- System treats as information
- Track separately if needed
Q: How does payroll handle holidays?
A:
- Active holidays are paid time off
- Employees receive full salary
- Holiday pay included in paycheck
- Payroll must be notified
Troubleshooting
Problem: Can't create a holiday
Solution:
- Ensure all required fields filled (name, date, type)
- Check date format is correct
- Verify no duplicate holidays
- Try refreshing page
- Contact support if error persists
Problem: Holiday doesn't appear on calendar
Solution:
- Check if holiday is set to Active
- Refresh the calendar page
- Verify date is correct
- Check calendar permissions
- May need to clear cache
Problem: Can't edit a holiday
Solution:
- Check if you have edit permissions
- Ensure all required fields filled
- Verify date format correct
- Refresh page
- Try different browser
Problem: Delete button not working
Solution:
- Confirm you have delete permissions
- Try clicking again
- Refresh page
- Use different browser
- Contact support
Problem: Holiday affecting payroll incorrectly
Solution:
- Verify holiday is correct type
- Check if Active/Inactive status correct
- Confirm payroll processed after change
- Contact payroll team
- May need manual adjustment
Best Practices for Holiday Management
Practice 1: Plan Ahead
Plan all holidays for the year before it starts.
Practice 2: Communicate Clearly
Announce holidays and changes to all staff.
Practice 3: Use Descriptions
Add detailed descriptions for each holiday.
Practice 4: Regular Review
Review and update holiday list annually.
Practice 5: Coordinate
Work with payroll and finance on holidays.
Practice 6: Archive Properly
Deactivate old holidays instead of deleting.
Practice 7: Test Changes
Test new holidays before full activation.
Practice 8: Document Decisions
Keep notes on why holidays were added/removed.
Practice 9: Maintain Consistency
Apply same rules to all holidays.
Practice 10: Update Systems
Ensure all systems (calendar, payroll, etc.) are updated.
Integration with Other Systems
Calendar System
- Active holidays display on HR Calendar
- Color-coded as red/holiday color
- Updates automatically
- Employees see on their calendar
Payroll System
- Payroll receives active holidays
- Calculates holiday pay automatically
- Includes in employee salary
- No deduction needed
Attendance System
- Holidays marked in attendance
- Employees get holiday mark (not absent)
- Excludes from absence calculations
- Affects attendance reports
Leave Request System
- System prevents leave on active holidays
- Blocks conflicting requests
- Uses holiday info in calculations
- Protects leave balance
Dashboard
- Holiday count shown
- Upcoming holidays listed
- Quick reference available
- Alerts for upcoming holidays
Legal and Compliance Notes
Important Reminders
- Follow local labor laws on holidays
- Ensure all mandatory holidays included
- Respect religious holidays
- Document holiday policy
- Maintain consistent application
- Pay employees correctly for holidays
- Keep audit trail of changes
- Verify payroll compliance
Performance Metrics
Metrics to Track
-
Total Holidays per Year
- Count all active holidays
- Compare to industry standard
-
Holiday Distribution
- Spread throughout year
- Balanced across seasons
-
Paid vs. Unpaid
- How many are paid
- How many are unpaid
- Cost implications
-
Compliance
- All legal holidays included
- Policy complied with
- No conflicts
Need More Help?
- Ask your HR Director or Manager
- Review company holiday policy document
- Contact HR Department
- Check system administrator guide
- Consult labor law resources
Key Features Summary
| Feature |
What It Does |
How to Use |
| Create Holiday |
Add new holiday |
Click Create button |
| Edit Holiday |
Modify holiday details |
Click Edit icon |
| Delete Holiday |
Remove holiday |
Click Delete icon |
| View Details |
See full information |
Click View icon |
| Toggle Status |
Activate/deactivate |
Click Status toggle |
| List All |
View all holidays |
Open holiday page |
| Export |
Download holiday list |
Click Export button |
| Set Date |
Choose holiday date |
Use date picker |
| Set Type |
Regular or Special |
Select from dropdown |
| Add Description |
Add details |
Type in description field |
Last Updated: December 10, 2025
Version: 1.0
For: HR Managers, HR Specialists, HR Directors, Payroll Staff, System Administrators