> ## Documentation Index
> Fetch the complete documentation index at: https://beebole.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public holidays: country calendars and custom days

> Set up country-specific public holiday calendars and add custom or regional holidays for your team in Beebole to streamline absence and capacity planning.

Beebole's public holidays feature lets you define which days are non-working days for your team. You can load country-specific public holiday calendars and add custom holidays to match your organization's schedule. Public holidays appear on timesheets and are factored into work schedule calculations, reports, and time-off balances.

<Info>
  Public holidays work alongside [work schedules](/help/documentation/work-schedule). When a public holiday falls on a scheduled work day, Beebole automatically accounts for it in capacity and reporting calculations.
</Info>

***

## Loading a country-specific calendar

Beebole includes built-in public holiday calendars for many countries. Loading a calendar pre-fills the standard national holidays for the selected year.

<Steps>
  <Step title="Open the Public holidays panel">
    Go to **Settings** > **Account Settings** and open the **Public holidays** panel. The same panel is also available on a tag or a person — see [Assigning holidays to specific groups](#assigning-holidays-to-specific-groups).
  </Step>

  <Step title="Select a country">
    Choose the **Country** — and optionally a **Region** and **Language** — then click **Load holidays**. Beebole populates the calendar with that country's official public holidays.
  </Step>

  <Step title="Review the holidays">
    Check the list of imported holidays for the selected **Year**. You can remove any that do not apply to your organization or edit their dates and names. Every change is saved automatically.
  </Step>
</Steps>

<Tip>
  If your team spans multiple countries, you can assign different public holiday calendars to different groups using tags. This ensures each person sees only the holidays relevant to their location.
</Tip>

***

## Adding custom holidays

You can add holidays that are specific to your organization — company-wide days off, regional observances, or any other non-working day not covered by the built-in calendars.

<Steps>
  <Step title="Open the Public holidays panel">
    Go to **Settings** > **Account Settings** and open the **Public holidays** panel (or open the panel on the relevant tag or person).
  </Step>

  <Step title="Add a holiday">
    In the empty row at the bottom of the holiday list, pick the date and type the holiday's name, then click **Add**. The custom holiday is saved and appears in the calendar alongside any country-specific holidays.
  </Step>
</Steps>

***

## Editing and removing holidays

To modify an existing holiday, click its date or name in the list and update it — changes are saved automatically. To remove a holiday, click the remove icon at the end of its row.

<Warning>
  Removing a public holiday may affect timesheet calculations and reports for periods that include that date. Review any submitted or approved timesheets that overlap with the removed holiday.
</Warning>

***

## Assigning holidays to specific groups

By default, the calendar configured on **Account Settings** applies to everyone in your account. If your organization has teams in different countries or regions, the same **Public holidays** panel is available on tags and people:

* **By tag** — Click **Tags** in the sidebar, open the tag (e.g., "US Office", "UK Office"), and configure its **Public holidays** panel so only people with that tag get those holidays.
* **By person** — Click **People** in the sidebar, open the person, and configure their **Public holidays** panel to override the calendar for that individual.

This ensures each person's timesheet reflects the correct public holidays for their location.

<Info>
  When a person has both a tag-level and a person-level holiday calendar, the person-level setting takes priority.
</Info>

***

## How public holidays affect timesheets and reports

Public holidays interact with several parts of Beebole:

| Area                  | Effect                                                                                                                                        |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Timesheets**        | Public holidays are highlighted on the timesheet. Depending on your settings, people may or may not be required to log time on these days.    |
| **Work schedules**    | Public holidays reduce the expected working hours for the period. A person's capacity calculation accounts for public holidays automatically. |
| **Reports**           | Reports that include capacity or availability metrics factor in public holidays when calculating expected versus actual hours.                |
| **Time off balances** | Public holidays do not count against a person's time-off allowance — they are separate from absence types like vacation or sick leave.        |

***

## Year-to-year management

Public holiday calendars are managed per year through the **Year** selector in the **Public holidays** panel. The selector covers a rolling window of two years back and three years ahead, so you can review recent past years as well as prepare upcoming ones.

At the start of each new year:

<Steps>
  <Step title="Select the new year">
    In the **Public holidays** panel, pick the new year in the **Year** selector. Beebole loads the country's official holidays for new years automatically as they become available.
  </Step>

  <Step title="Review and adjust">
    Some public holidays shift dates year to year (e.g., Easter). Verify that all dates are correct for the new year, and add any custom holidays again — they are defined per year. Every change is saved automatically.
  </Step>
</Steps>

<Info>
  Need to switch countries? Pick a new **Country** (and **Region**, if any) and click **Load holidays** — the country can be changed at any time. Every year's holidays, past years included, re-derive from the new country; your own custom edits are kept when you reload the same country.
</Info>

<Info>
  Previous years' holiday calendars remain in the system for historical reporting. Updating the current year does not affect past data.
</Info>

***

## Related content

<CardGroup cols={2}>
  <Card title="Time Off" icon="calendar" href="/help/documentation/timeoff">
    Configure absence types and allowances that work alongside public holidays.
  </Card>

  <Card title="Accruals" icon="clock" href="/help/documentation/accruals">
    Set up automatic leave accrual policies linked to absence types.
  </Card>

  <Card title="Work Schedule" icon="users" href="/help/documentation/work-schedule">
    Define working hours so public holidays reduce capacity correctly.
  </Card>

  <Card title="Tags" icon="folder" href="/help/documentation/tags">
    Use tags to assign country-specific holiday calendars to different groups.
  </Card>
</CardGroup>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Do public holidays count against a person's time-off balance?">
    No. Public holidays are separate from absence types like vacation or sick leave. They reduce the expected working hours for a period but do not consume any time-off allowance.
  </Accordion>

  <Accordion title="Can I have different holiday calendars for different offices?">
    Yes. Configure the **Public holidays** panel on a tag to give that group its own calendar. For example, load the US calendar on the "US Office" tag and the UK calendar on the "UK Office" tag.
  </Accordion>

  <Accordion title="What happens if a public holiday falls on a weekend?">
    Beebole applies the holiday to the date as configured. If the holiday falls on a non-working day according to the person's work schedule, it has no effect on their expected hours. If your country observes a substitute day (e.g., the following Monday), add that substitute date as a custom holiday.
  </Accordion>

  <Accordion title="Do I need to reload the calendar every year?">
    No. Once a country calendar is configured, Beebole loads the country's official holidays for new years automatically as they become available. Use the **Year** selector to review them, and add your custom holidays for each new year — those are defined per year.
  </Accordion>

  <Accordion title="Can I bulk-import public holidays?">
    The fastest approach is to load a built-in country calendar, which imports all national holidays at once. You can then add or remove individual entries as needed.
  </Accordion>
</AccordionGroup>
