Schedules & Calendars: A Guide to Managing User Working Patterns

Overview

Kompass uses two distinct but related concepts to define when and how employees work:

  • Schedules define the day-to-day working pattern for a user: which days they work, their start and end times, break allowances, and how those hours count towards availability, billing, and pay.
  • Calendars define public and bank holidays. A calendar is a named list of holiday dates that gets layered on top of a user's schedule to exclude holidays from leave calculations, mark them in the resource schedule view, and add holiday entries to timesheet exports.

Together, a user's schedule and calendar determine their effective working days, theoretical billable hours, and how hours recorded in their timesheets are counted.


Part 1: Schedules

What Is a Schedule?

A Schedule is a template that defines the working pattern across the days of the week. Each schedule contains one or more Schedule Days, each of which describes the working hours for a specific day type (Monday through Sunday, a Default fallback, or a special Holiday rule).

Schedules are managed in Kompass Admin at Diary → Schedules.

Schedule Day Settings

Each row within a schedule represents a single day type. The columns you will see are:

Field What it does
Weekday Which day this row applies to. Options: Default, Monday–Sunday, Holiday (see below).
Start time The working day start time (e.g. 08:00).
End time The working day end time (e.g. 17:00).
Breaks Default break time in minutes, pre-filled when a user creates a diary entry on this day.
Travel Default travel time in minutes, pre-filled when a user creates a diary entry on this day.
Schedule available ✅ If ticked, the user will appear on the Schedule (resource) view as available on this day. This controls visibility in the resource planner.
Diary entry ✅ If ticked, the user's diary will be pre-filled with an empty entry row for this day to prompt them to log their time.
Billable ✅ If ticked, hours on this day count towards the user's theoretical billable hours shown on the dashboard. This is how Kompass knows how many hours a person should be billing.

A typical Monday–Friday schedule will have Schedule available  , Diary entry  , and Billable   all ticked for Monday through Friday, and no rows (or unticked rows) for Saturday and Sunday.


The "Default" Weekday

The Default row is a fallback. If a user records a diary entry on a day that does not have a specific row in their schedule (for example, they occasionally work on a Monday but the schedule only defines Tuesday–Thursday), Kompass uses the Default row's times and settings for that entry.

The "Holiday" Weekday (Weekday = 8)

The Holiday row is a special override. Normally, when a date falls on a bank holiday (from the user's assigned Calendar), it is excluded from leave day calculations. If you add a Holiday row to a schedule, those days are treated as working days for leave calculations. Tick Billable as well if the hours should count towards the user's theoretical billable hours. This is how you say: "Users on this schedule are expected to work bank holidays, and those hours count as billable."

This is useful for deployments where some employees are contractually required to work on bank holidays (e.g. emergency services, 24/7 operations).

Please note that you can explicitly change the number of hours for Holiday by adding different start and end hours.

Schedules and Orgs

Each schedule is associated with one or more Organizations (Orgs) in the Assigned Orgs inline at the bottom of the Schedule form. A user can only be assigned a schedule that belongs to their org. The org's Diary configuration also holds a schedule_default; the fallback schedule used for any user who has not been explicitly assigned one.


Part 2: Assigning a Schedule to a User

There are two places where a schedule can be assigned to a user: the frontend Employee Detail page for everyday use, and Kompass Admin for advanced date-range management.


Via the Frontend (Employees → Employee Detail)

Navigate to Employees → [select an employee] in the Kompass frontend. On the Details tab, in the Role section, you will find a Schedule dropdown (visible only to users with the view_schedule   permission).

This dropdown lists the schedules belonging to the user's org. Selecting one and saving applies it from today, or from the employee's start date if that is later. This is the quickest way to assign or change a schedule for a single user without needing admin access.

The frontend schedule field applies the chosen schedule from today, or from the employee's start date if that is later, and does not let you choose a date range. It reflects the user's current working pattern. For historical or future-dated schedule changes (e.g. tracking a move from full-time to part-time), use the Kompass Admin approach below.

Via the Kompass Admin (Advanced: Date-Range Assignments)

For more complex scenarios, particularly where a user's working pattern has changed or will change over time, schedules are managed in the User schedules inline on the User admin page (Kompass Admin → Users → select a user → scroll to the User schedules section).

Each assignment has:

Field Description
Schedule Which schedule template to apply. Only schedules belonging to the user's org are shown.
Start The date from which this schedule applies (nullable = "from the beginning of time").
End The date until which this schedule applies (nullable = "open-ended").

You can assign multiple schedules to a single user with different date ranges. This supports employees who change their working pattern over time (e.g. moving from full-time to part-time, or returning from a career break).

Important: Date ranges on a user's schedules must not overlap. Kompass Admin will reject overlapping entries.

Schedule Fallback Chain

When Kompass needs to know a user's working pattern for leave calculations or diary pre-fill, it resolves the schedule in this order:

  1. The UserSchedule   record whose date range covers the date in question, if one exists.
  2. If no UserSchedule   covers that date, the org's default schedule (from the Diary configuration) is used.

In the resource Schedule view, the org's default schedule is used only when a user has no schedule assignments. A gap between existing assignments remains unscheduled.


Part 3: Calendars and Holidays

What Is a Calendar?

A Calendar is a named collection of holiday dates (bank holidays). Calendars are managed in Kompass Admin at Calendars → Calendars, with their dates in Calendars → Holidays.

A calendar has:

Field Description
Name A descriptive name (e.g. "England & Wales", "Germany – Bayern", "US Federal Holidays").
Start / End Optional date range for when the calendar is active (typically left blank).

Each Holiday record within a calendar has:

Field Description
Calendar Which calendar this holiday belongs to.
Day The date of the holiday.
Name A descriptive label (e.g. "Christmas Day", "Tag der Deutschen Einheit").

Calendar Resolution per User

Calendars can be applied at two levels:

  1. Org level: the org's default calendar applies to all users in that org (set on the Org record).

  1. User (Profile) level: an individual user's profile can have a specific calendar assigned, which overrides the org-level calendar for that user.

The active calendar for any given user is resolved as: profile calendar (if set) → otherwise, org calendar.

This is what makes it possible to support employees working under different national holiday regimes within the same deployment.


Part 4: Supporting Employees in Different Countries

This is one of the most important practical use cases for calendars. If your organization has employees based in different countries, for example, some in the UK and some in Germany, they will observe different public holidays. Kompass handles this cleanly by assigning each group of employees their own calendar.

Step-by-step: Setting Up Multi-Country Holidays

Step 1: Create a calendar for each country or region

Go to Kompass Admin → Calendars → Calendars and click Add calendar.

Create one calendar per distinct set of holidays:

  • "England & Wales"
  • "Germany"
  • "US Federal"

Step 2: Add the holidays to each calendar

Go to Kompass Admin → Calendars → Holidays and click Add holiday for each bank holiday, selecting the correct calendar and setting the date and name.

Step 3: Set the default calendar at org level (optional)

If the majority of your users follow a single country's holidays, set that calendar as the org default via Kompass Admin → Company → Orgs → [your org] → Calendar. You can also change it in Configuration, under Organisations; see Configuration: company settings.

Step 4: Override the calendar at user level for employees in other countries

For employees who observe different holidays, go to Kompass Admin → Users → [select user] → Profile section → Calendar and select the appropriate country calendar.

That user will now have their leave working-day calculations, timesheet exports, and the holiday shading on their row in the schedule view driven by their individual calendar rather than the org default.


Part 5: How Calendars Affect the Rest of Kompass

Once assigned, a user's calendar has the following effects:

Leave Calculations

When Kompass calculates how many working days a period of leave spans, it excludes dates that fall on a bank holiday in the user's active calendar. For example, if an employee books leave over Christmas week, the bank holidays (Christmas Day, Boxing Day, etc.) are automatically excluded and do not count against their leave allowance.

The exception: if the user's schedule includes a Holiday row (weekday = 8), that overrides the exclusion. Those days are treated as working days even when they coincide with a calendar holiday.

Timesheet Exports

When exporting timesheet data, Kompass generates pseudo timesheet entries for bank holidays. For each holiday in the user's calendar, the export includes a holiday entry showing the expected hours for that day (derived from the user's schedule). This allows payroll and reporting tools to account for paid public holidays without requiring employees to manually log them.

The Schedule (Resource) View

The schedule view, which shows task assignments, leave, and resource availability across the team, marks bank holidays inline on the calendar grid. The column headers use the org's calendar, and each user's row shades the holidays from their own calendar, so team members in different countries see their respective national holidays on their rows.


Part 6: Quick Reference: Who Sets What

Action Where in Kompass Admin
Create / edit a Schedule Diary → Schedules
Add Schedule Days to a Schedule Inline on the Schedule record
Assign a Schedule to a User Users → [user] → User schedules inline
Set the org default Schedule Diary → Configurations → [org config] → Schedule default
Create a Calendar Calendars → Calendars
Add Holidays to a Calendar Calendars → Holidays
Set the org default Calendar Company → Orgs → [org] → Calendar
Override a user's Calendar Users → [user] → Profile → Calendar

Summary

Concept Purpose Set on
Schedule Defines working days, times, and how hours count (available / billable / diary pre-fill) Kompass Admin → Diary → Schedules
User Schedule Assigns a schedule to a specific user for a date range Kompass Admin → Users → user record
Calendar Names a set of bank holidays for a region or country Kompass Admin → Calendars → Calendars
Holiday A single bank holiday date within a calendar Kompass Admin → Calendars → Holidays
Org calendar Default holidays for all users in an org Kompass Admin → Company → Orgs
Profile calendar Per-user override for employees under different national holidays Kompass Admin → Users → Profile
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us