Skip to main content
All topics Company settings Documentation library
Company settings Updated 2026-03-16

Holiday management (admin)

Hub at /admin/holidays: year navigation, holiday statistics, Sync (multi-country API), preload next year, country filter, table/cards of public holidays; weekday vs weekend counts affect leave math per in-app notes.

Route /admin/holidays Roles Company admin · Super admin · HR manager
Try it live: use the Acme demo (e.g. company admin) after signing in at the normal login page.

Holiday Management at /admin/holidays is the public holiday library for your product region set: browse by year, filter by country code, sync dates from the external holidays feed (multi-country), and preload the following calendar year when you need it ahead of the automatic job.

Navigation: top bar Settings → Holidays. This is separate from Company settings (/company/settings) but complements how employees see time off on calendars.

Overview

The screen is organized into Holiday Statistics (counts and types for the selected scope), Sync Holidays (POST to run the sync artisan command for the visible year and bundled country list), Next Year Preload (status + button to preload the next calendar year after the one you’re viewing), a Filter by Country control, then the main Public Holidays table (desktop) or cards (mobile). When viewing All Countries, a Holiday Summary by Country table may appear below.

Who can open it

Anyone passing the app’s admin-tier gate — typically company administrators, HR managers, super administrators, and internal platform admin accounts. Other roles are redirected away from /admin/holidays.

Year, sync & preload

  • Year — Previous year, Current Year, and Next year links change the year query parameter.
  • Sync {year} Holidays — loads/updates public holidays for that year via the configured sync (multiple countries in one action on this form). Success and error flashes appear at the top after redirect.
  • Preload — prepares the next calendar year’s data; the card shows whether that year is already preloaded and when. The UI notes an automatic run on December 15.

The blue Holiday Management Info panel at the bottom summarizes automation (e.g. January 1 sync), weekend exclusion rules for leave math, and which holiday types are eligible when syncing.

List & country filter

Use Filter by Country to narrow the list to one ISO-style code or keep All Countries. Rows include date, weekday, name, country, and type; weekend rows are highlighted. If nothing is in the database for that year yet, the page prompts you to run Sync first.

Calendars & leave

Holiday names feed employee and manager calendars. The product distinguishes weekday vs weekend observances — only Mon–Fri holidays count against typical leave allowance logic (see the on-page note when “All Countries” summary is shown).

Work locations (admin) — physical sites, not public holidays · Custom leave types — when enabled · Calendar: Team timeline.

Product screenshot

Automated capture: full page after admin login (current year; demo DB with holiday rows).

Product screenshot
Holiday Management: stats cards, sync and preload actions, country filter, and holidays table.

Holiday management — /admin/holidays