Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
    • Pick-up and Delivery Routing
    • Task Scheduling
  • Platform
Start Free Trial
  • Employee Shift Scheduling
  • The basics
  • User guide
  • Visualization
  • latest
    • latest
    • 1.36.x
    • 1.35.x

Employee Shift Scheduling

  • The basics
    • Introduction
    • Getting started: Hello world
    • Lessons overview
      • Lesson 1
      • Lesson 2
      • Lesson 3
      • Lesson 4
      • Interlude 1: Basic demo data
      • Lesson 5
    • User guide
      • Terminology
      • Use case guide
      • Scheduling API concepts
      • Integration
      • Constraints
      • Using the API
        • Using the OpenAPI spec
        • API tooling
      • Demo datasets
      • Input datasets
        • Model configuration
        • Model input
        • Planning window
      • Planning window
      • Time zones and Daylight Saving Time (DST)
      • Tags and tag types
      • Input validation
      • Output datasets
        • Metadata
        • Model output
        • Input metrics
        • Key performance indicators (KPIs)
      • Metrics and optimization goals
      • Score analysis
      • Visualization
      • Efficiency X-Ray
      • Assignability analysis
  • Feature guides
    • Employee resource constraints
      • Employee availability and preferences
        • Employee availability
        • Employee preferences
      • Employee contracts
      • Employee priority
      • Pairing employees
      • Employee groups
      • Shift travel and locations
      • Shift Breaks
      • Employee activation
      • Work limits
        • Minutes worked per period
        • Minutes worked in a rolling window
        • Minutes logged per period
        • Days worked per period
        • Days worked in a rolling window
        • Consecutive days worked
        • Shifts worked per period
        • Shifts worked in a rolling window
        • Weekend minutes worked per period
        • Weekends worked per period
        • Weekends worked in a rolling window
        • Consecutive weekends worked
        • Consecutive shifts worked
      • Time off
        • Days off per period
        • Consecutive days off per period
        • Consecutive days off in a rolling window
        • Consecutive minutes off in a rolling window
        • Shifts to avoid close to day off requests
        • Consecutive weekends off per period
      • Shift rotations and patterns
        • Shift rotations
        • Single day shift sequence patterns
        • Minimize gaps between shifts
        • Multi-day shift sequence patterns
        • Daily shift pairings
        • Overlapping shifts
        • Shift start times differences
        • Minutes between shifts
      • Shift type diversity
        • Shift tag types
        • Shift types worked per period
        • Unique tags per employee per period
      • Fairness
        • Balance time worked
        • Balance shift count
    • Shift service constraints
      • Alternative shifts
      • Cost management
        • Cost groups
        • Employee rates
      • Demand-based scheduling
      • Priority and optional shifts
      • Skills and risk factors
      • Shift assignments
        • Shift selection
        • Employee selection
    • Scenarios
      • Configuring labor law compliance
      • Configuring employee well-being
      • Self-rostering and optimization
  • Responding to change
    • Manual intervention
    • Recommendations
    • Real-time planning
  • More information
    • Changelog
    • Upgrade to the latest version
    • Feature requests

Visualization

Learn how to use the low-level validation views in the Employee Shift Scheduling model to validate individual shifts and employee schedules. These views work at the most granular level of the schedule. Use them when you investigate specific assignments or explain individual results to planners and stakeholders.

By employee

By employee visualization

Primary focus: Detailed employee-level validation.

The By employee view organizes the schedule by employee. Each row shows:

  • Assigned shifts

  • Unavailability periods

  • Preferences and unpreferences

  • Skill tags and contract types

  • Worked hours, on a bar that spans the row header

The timelines apply the model’s own rules:

  • Skill marks follow skill validity.

  • A shift shows as preferred or unpreferred as soon as it overlaps that time.

  • Overlapping shifts that are permitted aren’t marked as overlaps.

  • Time outside an employee’s available time spans shows as unavailable.

Pagination controls allow you to navigate through the employees. Pagination is ordered by employee ID.

Filtering

Every visualization view supports filtering. Click Filter to open the filter pane and drill down into a subset of the data. Combine multiple filters to narrow the view to exactly the data you want to inspect. Each filter lists its values with the number of items that match it and the other selected filters, 0 included. The Filter button shows how many values are selected, and Reset filter clears the selection.

Filter panel on the By employee visualization

In the By employee view, you can filter by employee, skill, contract type, and more.

Dates

The date control after the tabs sets the days that the timeline and the filters show, up to 7 days. The view opens on the first day with a shift: the first assigned shift in By employee, and the first shift in By shift. Reset filter keeps the selected dates. The time zone readout at the right end of the tab row shows the UTC offset of every time in the view.

By shift

By shift visualization

Primary focus: Detailed shift coverage validation.

The By shift view shows the schedule as a time-based grid of shifts across days.

Each block represents a shift and displays:

  • Assigned employees (or "Unassigned" if not covered).

  • Shift details like required skills, priority, start and end time (hover over the shift for details).

Pagination controls allow you to navigate through the shifts. Pagination is ordered by shift ID.

Filtering

Every visualization view supports filtering. Click Filter to open the filter pane and drill down into a subset of the data. Combine multiple filters to narrow the view to exactly the data you want to inspect. Each filter lists its values with the number of items that match it and the other selected filters, 0 included. The Filter button shows how many values are selected, and Reset filter clears the selection.

In the By shift view, you can filter by shift ID, tags, skills, and more.

Dates

The date control after the tabs sets the days that the timeline and the filters show, up to 7 days. The view opens on the first day with a shift: the first assigned shift in By employee, and the first shift in By shift. Reset filter keeps the selected dates. The time zone readout at the right end of the tab row shows the UTC offset of every time in the view.

Hover cards

Hover cards stay open, so you can select and copy their text. The shift card has a button that copies the shift ID, and shows the shift’s priority as a badge.

Other views

The By shift and By employee views validate individual assignments, but they don’t reveal structural patterns across the whole dataset.

To detect coverage, overtime, and fairness issues at a strategic level, use the Efficiency X-Ray.

To identify shifts that are impossible or difficult to fill before optimization runs, use Assignability analysis.

See Recommended analysis workflow for a structured approach that combines all views.

Recommended analysis workflow

A structured approach:

  1. Use Assignability analysis to detect structurally impossible or difficult-to-fill shifts in the input data before optimization.

  2. Dive deeper into By Shift Efficiency X-Ray to see high-level coverage bottlenecks in the optimized result.

  3. Inspect problematic time slots in By shift.

  4. Review affected employees in By employee.

  5. Validate utilization and fairness in By Employee Efficiency X-Ray.

  6. Use these insights to inform strategic decisions, fix input data issues and test different scenarios with Experiments.

Next

The visualizations help you understand the what of a schedule, which is a first step to understanding the why and the so what.

  • For guidance on how to validate and explain optimized plans, see the Validating an optimized plan with Explainable AI guide. This guide explains why trust and explainability matter when presenting a plan to planners and stakeholders. How to check correctness, understand trade-offs, and communicate why certain assignments were made. It shows how visualizations, real-world metrics, and explainability features work together to build confidence in a schedule rather than treating it as a black box.

  • For a broader view on diagnosing and resolving operational bottlenecks, the Uncovering inefficiencies in operational planning guide provides useful context. It discusses common sources of planning inefficiencies (such as under- or over-utilization, skill mix issues, and demand imbalances) and how planning optimization can help you pinpoint structural problems in your workforce plan.

  • Once you’ve identified a scenario worth testing, use Experiments to systematically compare it against your baseline before applying it to production.

  • © 2026 Timefold BV
  • Timefold.ai
  • Documentation
  • Changelog
  • Send feedback
  • Privacy
  • Legal
    • Light mode
    • Dark mode
    • System default