The article below pertains to editing your schedule within our Manager portal, not when using our APIs or scheduling on Mobile. To see validations done when scheduling on mobile, please take a look at Schedule Validations page.
When you create, edit, or delete shifts in the Manager portal, Quinyx automatically checks those shifts against the compliance rules you’ve configured. These rules come from the Schedule Compliance settings and can be linked either to the unit or to an employee’s agreement.
The table below provides an overview of all available rules. For each rule, you’ll see:
The category it belongs to (e.g., Working Time, Breaks, Rest)
The name of each rule
A short description of what the rule does
The key settings that influence how the rule is validated
Some rules can either be configured to use the setup on agreements or custom values in the rule itself. In the cases of using agreement value, the system will look at the employee in question and use that value to validate compliance.
Rule category
Rule name
Rule description
Configurable settings
Break
Exceeding working time without break
This rule refers to situations where an employee is scheduled to work beyond permitted number of consecutive hours without having a break.
This rule can be completely configured using Custom configuration, or using Agreement value.
For unassigned shifts it uses Advanced unit settings.
Location
Setting
What it controls
Allowed values/tips
Schedule Compliance > Rule set > Exceeding working time without break [rule]
Maximum time without a break
Max amount of time an employee is allowed to be scheduled without a break.
Max amount of time an employee is allowed to be scheduled without a break.
Hours - Float value minutes defined in hundreds of one hour
Account settings > Group management > Unit > Advanced unit settings
Maximum work hours w/o breaks (h)
Max amount of time an unassigned shift is allowed to be created/edited without a break.
Hours - Float value minutes defined in hundreds of one hour
Break
Max break duration
This rule establishes the upper limits for the maximum duration of any single break taken during a shift.
This rule can be completely configured using Custom configuration, or using Agreement value.
For unassigned shifts it uses Advanced unit settings.
Location
Setting
What it controls
Allowed values/tips
Schedule Compliance > Rule set > Maximum break duration [rule]
Maximum break time
Maximum break duration which can be scheduled in a shift.
Hours and minutes
Agreement / Agreement template > Rules for hours
Maximum break
Maximum break duration which can be scheduled in a shift.
Minutes - Integer value
Account settings > Group management > Unit > Advanced unit settings
Maximum break
Maximum break duration which can be scheduled in an unassigned shift.
Minutes - Integer value
Break
Max breaks per shift
This rule sets a limit on the number of separate break periods an employee is permitted to take during a single shift.
Location
Setting
What it controls
Allowed values / tips
Schedule compliance > Rule set > Max breaks per shift [rule]
Maximum number of breaks per shift
Maximum amount of breaks that are allowed to be scheduled
Integer
Account settings > Group management > Unit > Advanced unit settings
Breaks/shift
Maximum amount of breaks allowed within a single shift
Amount of breaks - Integer value
Break
Min. break duration
This rule limits the minimum duration for any single break taken during a shift and will be triggered if a shift's break duration is shorter than required.
This rule can be completely configured using Custom configuration, or using Agreement value.
For unassigned shifts it uses Advanced unit settings.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Min break duration [rule]
Minimum total break duration per shift
System support when creating or editing assigned shifts
Hours and minutes
Agreement > Agreement template > Break rules and schedule changes
Minimum break
System support when creating or editing assigned shifts
Minutes - Integer value
Account settings > Group management > Unit > Advanced unit settings
Minimum break
System support when creating or editing unassigned shifts
Minutes - Integer value
Break
Double break requirement
This rule ensures that long shifts include one or two breaks, based on shift duration. Short gaps between two shifts may count as breaks, treating multiple shifts as one.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Double break requirement [rule]
First-break trigger Required
How long a shift may run before the first break becomes mandatory.
Hours and minutes ( ≥ 0)
Must be < Second-break trigger
Schedule Compliance > Rule set > Double break requirement [rule]
Second break trigger Required
How long the same shift may run before a second break becomes mandatory.
Hours and minutes ( ≥ First-break trigger).
Value must exceed First break trigger; otherwise the rule is ignored
Schedule Compliance > Rule set > Double break requirement [rule]
Minimum break length
Minimum duration considered a valid break.
Hours and minutes
Schedule Compliance > Rule set > Double break requirement [rule]
Max gap to merge shifts
Long-day scheduling trick: if two shifts are separated by a gap ≤ this value, theyʼre treated as one shift and the gap as a break.
Hours and minutes ( ≥ 0). Set 0 to disable merging
Availability
Scheduled on bank holiday
This rule prevents employees from being scheduled on bank holidays unless explicitly permitted, indicated in the agreement or agreement template.
Location
Setting
What it controls
Allowed values / tips
Agreement / Agreement template > Rules for hours
Schedule bank holidays
When set to true (checked), employees can be scheduled on bank holidays
True or false
Availability
Consecutive bank holiday scheduling
This rule prevents an employee from being scheduled to work on multiple consecutive bank holidays in two consecutive years.
Location
Setting
What it controls
Allowed values / tips
Bank holidays > Bank holiday
Employees can work on this bank holiday two years in a row
When set to true (checked), employees can be scheduled on consecutive bank holidays of that type
True or false
Availability
Incompatible scheduling across bank holiday dates
This rule is triggered when scheduled on a date that has been configured not to be scheduled for the employee if there's a shift on a certain bank holiday for that same employee.
Location
Setting
What it controls
Allowed values / tips
Agreement / Agreement template > Bank holidays > Bank holiday
Excluded dates for scheduling
Selected dates which canʼt be scheduled if the employee is scheduled the bank holiday
Date picker
Availability
Employee skill is missing
This rule triggers when an employee is scheduled for a shift requiring a skill they do not possess or have not been certified for.
Location
Setting
What it controls
Account settings / Group settings > Shift types
Skills
Skills required for en employee to be eligible to work the shift
People > People details
Skills
Skills which an employee has, constitutes which shifts that employee can work
Availability
Employee unavailable
This rule is violated when an employee is scheduled during a time they have marked as unavailable in their agreement.
Location
Setting
What it controls
Allowed values / tips
Agreement / Agreement template > Rules for hours
Check availability
Turning on availability feature for the agreement
Checkbox
Agreement / Agreement template > Rules for hours
Week
Weekly rotation
Set to an integer, minimum of 1
Agreement / Agreement template > Rules for hours
Weekdays
What time ranges should be available
Time of day, start and end
Availability
Late schedule change
This rule prevents changes to an employeeʼs schedule after a defined cut-off (lock) period.
The rule also allows for configuring a reference time.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Late schedule change [rule]
Lock period
Cut-off period
Integer to set amount for the selected period
Schedule Compliance > Rule set > Late schedule change [rule]
Period
Granularity to validate
Drop-down list with selectable options; Days, Weeks or Months
Schedule Compliance > Rule set > Late schedule change [rule]
Reference time
Anchor point from which the backwards countdown for the period begins
Drop down list with selectable options: Start of the day, Start of Schedule period, Start of Week, Start of day (agreement), Start of shift
Agreement template > Rules for hours > Schedule changes
Lock period
Cut-off period
Integer to set amount for the selected period
Agreement template > Rules for hours > Schedule changes
Period
Granularity to validate
Drop-down list with selectable options; Days, Weeks or Months
Availability
No overlapping absence shifts
This rule prohibits assigning a shift to an employee who already has a recorded absence shift for the same time, preventing conflicts.
For this rule to work, the agreement template needs to have Allow override on overlapping shifts setting turned on. See configurable settings.
Location
Setting
What it controls
Allowed values / tips
Agreement / Agreement template > Rules for hours
Allow override on overlapping shifts
Decides on agreement level if the rule is valid or not
On or off
Availability
No overlapping absences
This rule prohibits assigning a shift to an employee who already has a recorded absence for the same time, preventing conflicts.
For this rule to work, the agreement template needs to have Allow override on overlapping shifts setting turned on. See configurable settings.
Location
Setting
What it controls
Allowed values / tips
Agreement / Agreement template > Rules for hours
Allow override on overlapping shifts
Decides on agreement level if the rule is valid or not
On or off
Availability
No shift during pending leave request
This rule is triggered when an employee is scheduled to work during a period for which they have submitted a leave request that has not yet been approved or rejected
Rest
Min consecutive rest between shifts
This rule enforces a minimum number of hours an employee must have off between two consecutive shifts on different days.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Min consecutive rest between shifts [rule]
Minimum consecutive rest per day
Minimum consecutive rest required per day
Hours and minutes
Agreement / Agreement template > Rules for hours
Min rest per day
Minimum consecutive rest required per day
Hours - Float value minutes defined in hundreds of one hour
Agreement / Agreement template > Rules for hours
Rest must be in connection with the daybreak
If the checkbox is ticked, the rule behaves differently; the employee needs to have a consecutive rest period on each day matching or longer than the minimum defined on the agreement
Rest
Min consecutive rest per week
This rule ensures that employees receive a continuous block of rest (e.g., 24+ hours) during a defined weekly period.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set >Min consecutive rest per week [rule]
Minimum consecutive rest per week
Minimum consecutive rest required per week
Hours and minutes
Agreement / Agreement template > Rules for hours > Rules for working time
Min rest per day
Minimum consecutive rest required per week
Hours - Float value minutes defined in hundreds of one hour
Agreement / Agreement template > Rules for hours > Rules for working time
Check minimum rest/week during any consecutive 7 day period
If checked, it validates any 7 days period connected to the scheduled shift
Rest
Min days off after working a set of days in a row
This rule requires employees to have a certain number of days off after working a specific number of consecutive days.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Min days off after working a set of days in a row [rule]
Minimum consecutive rest days
Amount of days off required consecutively
Days - Integer value
Schedule Compliance > Rule set > Min days off after working a set of days in a row [rule]
Working day period threshold
Max amount of consecutive days possible to schedule an employee
Days - Integer value
Agreement / Agreement template > Rules for hours
Free days
Amount of days off required consecutively
Days - Integer value
Agreement / Agreement template > Rules for hours
Max days
Max amount of consecutive days possible to schedule an employee
Days - Integer value
Rest
Min average consecutive weekly rest per period
This rule ensures that over a defined multi-week period, employees receive an average amount of consecutive rest per week that meets or exceeds the minimum requirement. It helps ensure compliance with long-term rest standards even if weekly rest varies.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Min average consecutive weekly rest period [rule]
Period (weeks) required
Defines the number of consecutive weeks over which the rest average is calculated.
Weeks - Integer value
Schedule Compliance > Rule set > Min average consecutive weekly rest period [rule]
Average rest (per week) required
Minimum number of consecutive rest hours per week, averaged across the selected period.
Rest
Weekends off per week or month
Ensure employees have a minimum number of weekends off. You can specify the number of free weekends over a variable number of weeks or per calendar month. Optionally, a buffer period can be configured. The buffer period defines a period around the weekend off which can also not be used for scheduling. For example, a buffer period of 11 hours ensures that the free period before Saturday and after Sunday together is at least 11 hours.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Weekends off per week or month [rule]
Check per month required
Ensures the number of weekends are checked per calendar month.
On or Off
Amount of weeks required
Period for which the number of weekends should be checked
Week - Integer value
Amount of weekends required
The amount of minimum weekends the employee should be off
Weekends - Integer value
Amount of buffer required
Duration around the weekend off which should also be free of shifts
Hours and minutes
Split days off per week
This rule guarantees that employees receive several full days off each week. The resting days in the week do not need to be consecutive. The buffer period defines a period around the day off which can also not be used for scheduling. For example, a buffer period of 11 hours ensures that the free period before the day off and after the day off together is at least 11 hours. Note that if the rest days are consecutive, the buffer is applied around the combination of the days off. For example, if Wednesday and Thursday are off, the free period before Wednesday and after Thursday must be at least 11 hours.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Weekends off per week or month [rule]
Number of days required
Number of days off per week
Days - Integer value
Amount of buffer required
Duration around the day off which should also be free of shifts
Hours and minutes
Consecutive days off per week
Ensure employees have a consecutive period of days off across several weeks. You can configure both the number of days and weeks. The buffer period defines a period around the consecutive days off which can also not be used for scheduling. For example, if Wednesday and Thursday are off, the free period before Wednesday and after Thursday must be at least 11 hours.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Weekends off per week or month [rule]
Number of weeks required
Period for which the number of days off should be checked
Weeks - Integer value
Number of days required
The amount of consecutive days off per period
Days - Integer value
Amount of buffer required
Duration around the weekend off which should also be free of shifts
Hours and minutes
Working time
Exceeding salary limit of employee's cost period
This rule is triggered when an employeeʼs scheduled or actual working hours result in total compensation that exceeds the predefined salary cap for their designated cost period. It is primarily used to support compliance with wage restrictions for Minijobbers in Germany, where strict earnings thresholds must not be surpassed within a monthly or yearly timeframe
Location
Setting
What it controls
Allowed values / tips
Agreement template > Working hours and periods
Cost periods
Period with Start date and length
Date picker and length [numeric]
Agreement template > Working hours and periods
Cost period values
Cost value for created cost period(s)
Working time
Max consecutive working days
This rule limits the number of days an employee can be scheduled to work in a row without a rest day.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Max consecutive working days [rule]
Maximum consecutive working days threshold
Maximum amount of days that can be scheduled for en employee in a row
Days - Integer value
Agreement / Agreement template > Rules for hours
Max days
Maximum amount of days that can be scheduled for en employee in a row
Days - Integer value
Working time
Max hours per day
This rule sets the maximum number of working hours an employee can be scheduled for in a single day.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Max hours per day [rule]
Maximum time per day
Maximum amount of time (hours and minutes) an employee can be scheduled in a day.
Hours and minutes
Agreement / Agreement template > Rules for hours
Max hours/day
Max hours an employee can be scheduled in a day
Hours - Float value minutes defined in hundreds of one hour
Working time
Max hours per period
This rule enforces a cap on the total number of working hours over a specific period (e.g., per month).
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Max hours per period [rule]
Period (weeks) required
Period length which to validate max hours
Drop-down list with selectable period of 1 - 12 weeks
Schedule Compliance > Rule set > Max hours per period [rule]
Maximum time required
Maximum hours allowed.
Hours and minutes
Working time
Max hours per week
This rule sets a maximum number of hours an employee is allowed to work in a given week.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Max hours per week [rule]
Maximum time per week
Max hours an employee can be scheduled in a week.
Hours and minutes
Agreement / Agreement template > Rules for hours
Max hours per week
Max hours an employee can be scheduled in a week.
Hours - Float value minutes defined in hundreds of one hour
Working time
Max workdays over X hours
This rule limits how many days within a defined time window an employee can work shifts that exceed a certain number of hours.
This rule can be completely configured using Custom configuration, or using Agreement value.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Max workdays over X hours [rule]
Working time limit
Time limit
Hours and minutes
Schedule Compliance > Rule set > Max workdays over X hours [rule]
Maximum number of exceeding days
Amount of occasions that max can occur
Needs to be ≤ Period length
Schedule Compliance > Rule set > Max workdays over X hours [rule]
Period length (days)
Time window for which the max should apply
Needs to be ≥ Maximum number of exceeding days
Agreement / Agreement template > Rules for hours
With over hours
Time limit
Hours - Float value
Agreement / Agreement template > Rules for hours
Maximum days
Amount of occasions that max can occur
Needs to be ≤ Period length
Agreement / Agreement template > Rules for hours
During days
Time window for which the max should apply
Needs to be ≥ Maximum number of exceeding days
Working time
Min shift length
This rule ensures that shifts meet a minimum duration, preventing excessively short work periods.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Min shift length [rule]
Minimum shift duration
Minimum length of a scheduled shift
Hours and minutes
Agreement / Agreement template > Rules for hours
Minimum shift length (h)
Hours - Float value minutes defined in hundreds of one hour
Working time
Nominal hours can't be exceeded
This rule restricts employees from working more than their assigned or contracted nominal hours over a given time period.
Location
Setting
What it controls
Allowed values / tips
Schedule Compliance > Rule set > Nominal hours can't be exceeded [rule]
Maximum working time per schedule period
Amount of hours to validate within the scheduling period which canʼt/shouldnʼ t be breached
Hours and minutes
Agreement / Agreement template > Working hours and periods
Working hours full time working hours
Amount of hours to validate within the scheduling period which canʼt/shouldnʼ t be breached
Hours - Float value minutes defined in hundreds of one hour
Agreement / Agreement template > Working hours and periods
Schedule period
The period length and start which the nominal hours should be validated against
This rule verifies that a recorded time punch exists for a scheduled shift. It is triggered when attempting to modify or delete a shift that already has a time punch. The rule is ignored when you delete the underlying punch as well.
General
Tag validity period
This rule enforces that specific tags assigned to the shift type of a shift are within their valid date range and not expired.
Updated
by
Daniel Sjögren
