Documentation

All the guides, templates, and JSON reference documentation you need to model your planning problems, understand the Planning Wizard steps, and stay in sync with Timefold Solver best practices.

Getting Started

Use the Planning Wizard to define problem statements, entities, values, and constraints. Export your JSON model or import pre-built templates for task assignment, rostering, routing, and maintenance planning.

JSON Reference

The solver accepts a flexible JSON schema. Document the required fields (entities, values, problem type, constraints) plus optional metadata such as skills, costs, and properties.

Constraints & Objectives

Learn how hard, medium, and soft constraints impact scoring, how to weigh penalties, and how the planner translates business rules into Timefold Solver constraints.

Guides & Resources

Reference material built for business users, analysts, and engineers.

Step-by-Step Wizard

Each wizard step builds your JSON model—problem statement, entities, values, constraints, and objectives. Use the UI comments to validate as you go.

Templates

Copy-ready JSON templates for common use cases (task assignment, rostering, routing) help you accelerate prototyping.

Community & Support

Our documentation points you to solver guidance, troubleshooting tips, and how to work with Timefold's APIs if you want to automate beyond the UI.