Skip to main content

Manage Public Holiday Groups

Learn how to create and manage Public Holiday Groups and how Public Holiday is used in Schedule, Timesheet and Payroll.

Written by StaffAny

Contents of this article are applicable to the following users

Tier: NA

Product: StaffAny

Platform: Web

Access Level: Owner, Manager, Supervisor, Staff

Learn how to create and manage Public Holiday Groups, add holidays manually or from a StaffAny template, and assign a group to newly added staff. Learn also how Public Holiday is used in Schedule, Timesheet and Payroll.

This guide will cover how to:


How Public Holidays Differ from Events

  • A Public Holiday is a special date in a Public Holiday Group assigned to a staff member. It applies according to that staff member’s group assignment.

  • An Event is a separate Special Date assigned to a section. It applies only staffs assigned to the section.

How special dates are handled when they happen on the same date

  • When an Event, a Public Holiday and a weekend fall on the same date, StaffAny uses Event first, then Public Holiday, then Weekend for the badge and workhour classification. A count-hours Shift Tag takes priority over all three.

How Public Holiday relates to Event

  • Public Holiday is counted in same work hours as Event. The labels Event/PH Hours, Event/PH Days and Event/PH Rate cover either type of date in Timesheets, Payroll and reports. Existing past Event dates remain traceable in Special Dates, Timesheets, Payroll and reports.


Create and Edit a Public Holiday Group

Create and edit Public Holiday Group from Special Dates.

To create a group:

  1. Go to Settings > Time and Attendance > Special Dates > Public Holiday Groups.
    ​

  2. Click Add Public Holiday Group.

  3. Enter a Group name.

  4. To assign all staff added in future to this group, select Assign newly added staff to this group.
    Note: Only one Public Holiday Group can have this setting enabled at a time.

  5. Then, add public holiday using Apply a Template or Add Manually.

    1. Click add Manually to add a Public Holiday

      1. Add name and save

    2. Click Apply a Template to create a list of Public Holidays directly. Note: StaffAny releases template every year for each country (SG, MY, ID). Learn more about the template lists here

      1. Pick a year and a template

      2. View the chosen template's list of Public Holiday. If suitable, click apply template

  6. Each date can only have 1 Public holiday. So adding a template or manually create a public holiday is blocked if it conflicts with existing public holiday's date

    1. Error for adding template that has public holiday date conflicts

    2. Error for adding public holiday manually that conflicts with existing public holiday date

  7. Review the public holiday in the list for each year.


    You can edit or delete a public holiday

    1. Edit public holiday (Change date or change name)

      1. Click edit on the public holiday row

      2. Make the changes and save

    2. Delete public holiday

      1. Click delete on a public holiday

      2. Confirm deletion

  8. Once done, Click Add to save the Public Holiday Group

To edit a public holiday group

  1. Click edit on a public holiday group

  2. Add, edit or remove a public holiday from the list as you like. Click save once changes are done

Note:

  • For Singapore organisations, a default public holiday group is generated by system. It auto applies the yearly Public Holiday template which is from the Ministry of Manpower's list.

  • For Indonesia, Malaysian and other countries, there's no default public holiday group

  • You can edit or delete an included holiday before you save the group. Changes to an archived Public Holiday Group are not available until the group is restored.

How adding, editing or deleting a public holiday affects records

StaffAny checks the old and new public-holiday dates for every staff member assigned to the group.

  • If an affected date is in a locked Timesheet, you must unlock the affected staff Timesheet before you can save an added, edited, moved or deleted public holiday.

  • After a permitted change is saved, StaffAny refreshes the affected unlocked workhours. Schedule badges and Timesheet Event/PH classification update for the affected dates, and the corresponding Event/PH Hours, Days and Rate can update. Locked Timesheet values stay unchanged.

  • A Payroll snapshot that already exists is not changed by a Timesheet update.

Before changing a Public Holiday Group or its holidays:

  • Review the staff assigned to the group.

  • Check whether the change affects an unlocked past Timesheet. A public holiday change that affects a locked Timesheet date cannot be saved until the affected Timesheets are unlocked.

  • Changing the group used for newly added staff does not change existing staff assignments. Assign existing staff individually from My Team.


Public Holiday Template

Staffany releases template every year for Singapore, Malaysia and Indonesia. These templates are created from official sources in each country. They can be used as first draft for your public holiday.

A template adds its holidays to the group; existing dates stay unchanged. Resolve every duplicate date before you apply the template. If any proposed change affects a locked timesheet period for staff assigned to the group, unlock the affected timesheets before applying the template.

These are the list of templates released for 2027:

Country

2027 PH template

Coverage

Singapore

Singapore 2027

National

Malaysia

Malaysia Johor 2027

Johor

Malaysia

Malaysia Kedah 2027

Kedah

Malaysia

Malaysia Kelantan 2027

Kelantan

Malaysia

Malaysia Melaka 2027

Melaka

Malaysia

Malaysia Negeri Sembilan 2027

Negeri Sembilan

Malaysia

Malaysia Pahang 2027

Pahang

Malaysia

Malaysia Penang 2027

Penang

Malaysia

Malaysia Perak 2027

Perak

Malaysia

Malaysia Perlis 2027

Perlis

Malaysia

Malaysia Selangor 2027

Selangor

Malaysia

Malaysia Terengganu 2027

Terengganu

Malaysia

Malaysia Sabah 2027

Sabah

Malaysia

Malaysia Sarawak 2027

Sarawak

Malaysia

Malaysia Kuala Lumpur 2027

Kuala Lumpur

Malaysia

Malaysia Labuan 2027

Labuan

Malaysia

Malaysia Putrajaya 2027

Putrajaya

Indonesia

Indonesia 2027

National

Indonesia

Indonesia Bali Hindu 2027

Bali Hindu

Indonesia

Indonesia Bali Non Hindu 2027

Bali non-Hindu


Archive Public Holiday Groups

Archive a Public Holiday Group when it is no longer needed. This archives the group, not an individual historical public-holiday record.

  1. Go to Settings > Time and Attendance > Special Dates > Public Holiday Groups > On the active groups list, select Archive for the group.
    ​

  2. Review the affected staff and automatic-assignment notice, then select Archive to confirm.
    ​

Note:

  • Archiving turns off automatic assignment for new staff and removes the group from staff currently assigned to it, when applicable. For the affected dates, StaffAny refreshes unlocked Timesheet workhours and removes the Public Holiday classification where it no longer applies. Locked Timesheet values remain unchanged.

  • Archived groups are shown in the archived list and are read-only. You can select Unarchive later, but StaffAny does not restore the group’s previous staff assignments or automatic assignment. Unarchiving alone therefore does not change Schedule, Timesheets or Payroll. Assign affected staff to a Public Holiday Group from My Team if needed; that assignment can refresh applicable unlocked workhours.


Assign a Public Holiday Group to Existing Staff

Assign a Public Holiday Group to an existing staff member when different teams observe different public holidays.

  1. Go to My Team and select the staff member > Open Work Information and select Public Holiday Group

  2. Choose the group that applies to the staff member, then save your changes.

Note

  • You can also use mass edit staff excel to update PH Group for multiple staff at once

  • Changing a staff member’s Public Holiday Group, including removing the assignment, can update affected unlocked past Timesheets. Schedule badges and the Event/PH classification update for applicable dates; locked Timesheet values remain unchanged. Lock past Timesheets before changing a group when you need to preserve their values.

  • Updating the field changes the assignment for that staff member; it does not change the group assigned to other existing staff or the group selected for newly added staff. To unassign a staff member, clear the Public Holiday Group field and save. A staff member without a group has no group-based Public Holidays applied.


See Public Holiday Information in My Team, Schedule, Timesheets and Payroll

A staff member’s Public Holiday Group determines the public holidays that apply to that staff member. StaffAny uses that assignment to show public holiday information and to classify eligible workhours.

My Team

  1. The Public Holiday Group field in a staff member’s Work Information controls which public holidays apply to that staff member.

  2. Career history use the renamed Event/PH Rate label. This rate can only be viewed for Wage Type as Hourly. Review the selected staff and the effective change before saving, especially when the change could affect an unlocked past Timesheet.
    ​

Schedule

  • In the web schedule’s Staff View, a PH badge appears on an applicable public holiday in day, week, 4-week and month views.

  • If more than one assigned Public Holiday Group has a public holiday on the same date, StaffAny shows one PH badge. Open the badge tooltip to see the public holiday name or names.

  • Scheduled cost estimates use the applicable Event/PH Hours, Event/PH Days and Event/PH Rate.

  • The mobile schedule also shows the badge. On mobile, the Schedule shows one PH badge for an applicable date even when several assigned Public Holiday Groups contain a public holiday on that date. Open the badge to check the public holiday name or names before reviewing the shift.
    ​

Timesheets

  • The Timesheet table shows the number of applicable public holidays in the Tag column.

  • In a staff member’s Timesheet detail and timecard

    • The PH badge appears for the relevant date; its tooltip shows the public holiday name. Event and weekend badges can appear there too.

    • The top PH count includes a Timesheet row only when its Total is numeric, including 0h.

    • The top Event/PH Hours calculates total Event and Public Holiday hours from all shift that has Event or Public Holiday tags

  • In Custom Timesheet columns:

    • Event Hours becomes Event/PH Hours and Event Days becomes Event/PH Days.

  • In Mobile Timesheet

    • On mobile, the Timesheet list continues to show dates with workhours. Open a date in the staff member’s Timesheet detail to see the PH badge and its public holiday name; Event and weekend badges are shown there using the same rule.
      ​

Note:

  • Timesheet lock effect to Timesheet

Timesheet exports and reports

  • In the individual Timesheet export, the hours column is labelled Event/PH Hours, and the Special Rates label uses Event/PH.

  • In the Timesheet summary export, Event/PH Hours is included in the total calculation. You can also add an Event/PH Days column.

  • Schedule-cost reporting distinguishes Scheduled Event/PH Hours and Actual Event/PH Hours, so planned and recorded hours can be reviewed separately.

Payroll

  • Payroll uses the renamed variables Event/PH Hours, Event/PH Days and Event/PH Rate. Existing organisation formulas using the earlier Event names are migrated to the new labels.

  • For the Event/PH pay item, the pay formula can use Event/PH Hours × Event/PH Rate × 1. The existing Event/PH pay item remains available.

  • The Special Rate uses the Event/PH Rate for shifts with workhours. Special Event/PH Remarks can include both public holiday names and existing Event remarks.

  • Changes to Timesheet data do not change an existing Payroll snapshot.


FAQ

Q: Can I apply more than one template to a Public Holiday Group?

A: Yes. Each application adds the selected template's holidays to the group. Existing dates remain unchanged, but duplicate dates must be resolved before you can apply another template.

Q: Why can't I apply a template or save a holiday change?

A: Check for duplicate public holiday dates. If the change affects a locked timesheet date or period for staff assigned to the group, unlock the affected timesheets first.

Q: What happens when I archive or unarchive a Public Holiday Group?

A: Archiving turns off automatic assignment, removes the group from assigned staff and refreshes applicable unlocked workhours. Locked Timesheet values remain unchanged. Unarchiving makes the group active again, but does not restore staff assignments or automatic assignment, so it does not itself change Schedule, Timesheets or Payroll.

Q: How is a Public Holiday different from an Event?

A: A Public Holiday comes from the staff member’s assigned Public Holiday Group. An Event is a separately recorded Special Date. If both apply on the same date, Event takes priority over Public Holiday for the badge and workhour classification.

Q: What changes when I assign or unassign a staff member’s Public Holiday Group in My Team?

A: The staff member gains or loses the selected group’s Public Holidays. Schedule badges and affected unlocked Timesheet workhours can update, while locked Timesheet values remain unchanged. The change does not reassign other existing staff or change an existing Payroll snapshot.

Q: Why is there one PH badge when more than one public holiday applies?

A: StaffAny shows one PH badge for the date. Open its tooltip to see the public holiday name or names from the staff member’s assigned groups.

Q: Why is a public holiday not included in the Timesheet PH count?

A: The top PH count includes only Timesheet rows with a numeric Total, including 0h. Check the row’s Total and the staff member’s Public Holiday Group assignment.

Q: Which Event/PH fields can I find in Timesheet exports?

A: Individual exports use Event/PH Hours and the Event/PH Special Rates label. Summary exports include Event/PH Hours in totals and can include Event/PH Days.

Q: What will I see in the mobile Schedule and Timesheet?

A: The mobile Schedule shows the PH badge for applicable dates. In the mobile Timesheet, open a date with workhours to see the PH badge and its public holiday name.

Did this answer your question?