Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
  • Platform
Try models
  • Employee Shift Scheduling
  • Introduction

Employee Shift Scheduling

    • Introduction
    • Planning AI concepts
    • Metrics and optimization goals
    • Getting started with employee shift scheduling
    • Understanding the API
    • User guide
      • Terms
      • Constraints
      • Planning window
      • Time zones and Daylight Saving Time (DST)
      • Tags and tag types
      • Validation
      • Score analysis
    • Employee resource constraints
      • Employee resource constraints
      • Employee availability
      • Employee contracts
      • Work limits
        • 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
      • Time off
        • 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
      • Shift rotations and patterns
        • 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 type diversity
        • Shift types worked per period
        • Unique tags per period
      • Fairness
        • Fairness
        • Balance time worked
        • Balance shift count
      • Pairing employees
      • Shift travel and locations
    • Shift service constraints
      • Shift service constraints
      • Alternative shifts
      • Cost management
      • Demand-based scheduling
      • Mandatory and optional shifts
      • Shift assignments
      • Skills and risk factors
    • Recommendations
    • Real-time planning
    • Changelog
    • Upgrade to the latest version
    • Feature requests

Introduction

The Employee Shift Scheduling model is one of Timefold’s Planning AI models and is available on the Timefold Platform.

The Employee Shift Scheduling model assigns shifts to employees with the goals of creating schedules that minimize labor costs, ensure proper shift coverage, and treats employees fairly and with respect.

The model is built using the Timefold Solver SDK and the application includes Timefold Enterprise Solver, a scalable optimization engine that can solve complex constraint satisfaction problems.

The Employee Shift Scheduling model includes constraints for:

  1. Matching employee availability, skills, and preferences with shifts.

  2. Complying with labor law and regulations.

  3. Scheduling priority shifts.

  4. Managing shift rotations and patterns.

  5. Keeping shift assignments within budget.

To learn more about individual constraints, see the Employee resource constraints and Shift service constraints guides.

Employee shifts view

Constraints have configurable weights, making them adjustable to meet different business goals and priorities.

The real time planning API makes plans adaptable when unforeseen events inevitably occur, and the recommendations API can help you figure out which employees to assign to which shifts.

The REST API layer is defined on top of the model and serves as a communication point with the engine to provide a stable interface that allows you to manage the lifecycle of the optimization problem, from submitting the initial dataset to retrieving the final solution.

Next

  • See the full API spec or try the online API.

  • Learn more about employee shift scheduling from our YouTube playlist.

  • Follow the Getting started guide.

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