Changelog
Follow up on the latest improvements and updates.
RSS
new
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
New smarter termination, model build insights, and model improvements (v0.50.1)
- Model build information in tenant settings: You can now view detailed build info for your models directly in tenant settings, including: Solver version, SDK version, Build commit, Build time. This helps you verify the version that is being used. (Especially useful for customers that run custom versions of models.)
- New smart termination: “After initial solution”: This option stops a run immediately after the construction heuristic produces the first solution. It’s useful when you want a quick look at the initial plan before further optimization.

- Additionally, we’ve made several under-the-hood improvements for a smoother experience, and updated the platform documentation on inviting tenant members for clarity.
- Improved scalability of movable visit handling: The performance of the custom move has been further optimized. Additionally, it now only activates for datasets where it brings measurable value, reducing unnecessary overhead.
- Disruption KPI bugfix: Fixed a bug where the Disruption KPI could behave incorrectly when running a score analysis on an existing run.
new
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Include unassigned visits in the output for Field Service Routing & other minor improvements (v0.49.0)
- Unassigned visits in the model output: We have added a new attributeunassignedVisitsto the model output. Only the visit IDs are included in the response, not the full visit objects. See Changelog for details. This change makes the finding of unassigned visits easier and more efficient.
- Improved scalability of movable visit handling: The performance of the custom move handling movable visits has been improved, especially for large datasets with many movable visits (assignable to multiple days).
- Fixed recommendation vehicle shift dependencies: Fixed a bug where vehicle shift dependencies were duplicated in the output and where some vehicle shifts weren't considered as dependencies.
- Floating breaks can be scheduled during waiting time before travel: Floating breaks can now be scheduled during the waiting time before travel starts, which allows for more efficient scheduling of breaks. This is especially useful for pinning. See Changelog for details.
- Disruption KPI: When submitting a schedule with already assigned employees, thedisruptionKPI is now always calculated. Before, this Disruption KPI was only calculated whendisruptionRuleswere provided. See the Real-time planning feature guide for details.
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Maintenance release (v0.48.0)
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Smaller bugfixes (v0.47.0)
- Audit Log filters: Some audit log event types were missing from the filtering options. These are now correctly displayed.
- Improved “New Run” dialog: We've enhanced the user experience when launching a new run for models with a large number of demo datasets.
- We’ve made several smaller performance improvements and bugfixes, e.g. to the “Visits finished in SLA” KPI’s. The UI will now better indicate when it’s an absolute value or a percentage.
- We’ve added an improved Route optimization feature guide to our documentation.
- We have updated penalties for several constraints to no longer include the shift's duration in the penalty. This change makes sure the solver does not treat shifts with different durations as more or less preferred than others. See changelog for details.
- We have fixed a bug where two soft constraints (Preferred weekends worked per period, Preferred shift start time difference) were treated as hard constraints. See changelog for details.
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Platform shows unprocessed input file and smaller bugfixes (v0.46.0)
- “Input” now showing unprocessed file: For any new runs, the “Input” page for a Model Run will now show the .json-file as it was submitted to the platform, without pre-processing. Before today we showed a version where default configuration values (from e.g. the configuration profile or tenant plan) were mixed in.
- We have fixed several small UI bugs.
- Visualization bugfix: We fixed a bug with character encoding in the visualization of the model.
- Visualization bugfix: We fixed a bug with character encoding in the visualization of the model.

- Support for external map providers for the Cloud platform: We now also support connecting external map providers to tenant on the Timefold Cloud Platform, not only on self-hosted installations. Learn more about external map providers. We have also made sure any configuration changes to location sets, maps deployments and external providers are logged to the Audit Log.
- Ability to plan routing problems spanning the full US: We now have a map in production spanning the full United States. View all available maps. (We still recommend people to pick the map with the smallest fitting region, as it will speed up the solving process.)
- We have improved our documentation on the lifecycle of runs in the platform to a.o. clarify what happens if a run is cancelled, and when webhooks are triggered.
- Deprecated /run and /new-run endpoints: The endpointsGET /v1/route-plans/{id}/runandPOST /v1/route-plans/{id}/new-runhave been deprecated, and replaced. See upgrade to the latest version for details.
- Working time fairness metric fix: We have fixed a bug that caused incorrect calculation of the Fairness metric when Full-time equivalent configuration was used in employee contracts.
- Deprecated /run and /new-run endpoints: The endpointsGET /v1/schedules/{id}/runandPOST /v1/schedules/{id}/new-runhave been deprecated, and replaced. See upgrade to the latest version for details.
new
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Improved invites, EU AI Act transparency and travel time constraints (v0.44.2)
- Improved member invite flows: When you invite colleagues to your tenant, they will now receive an invite email they must accept. This adds an extra layer of verification and clarity in onboarding.

- EU AI Act compliance documentation: We've published a new document detailing how Timefold complies with the EU AI Act. It highlights our transparent, deterministic approach and explains what this means for users.
- UI improvements and bugfixes: We've made several minor enhancements to the user interface (such as improving how you manage visible columns in the Run Overview) and fixed various bugs.
- New travel time constraints: You can now define constraints to limit the travel time of a vehicle shift, reflecting a technician’s preferences or requirements. Learn more in the Route optimization guide.
- Floating break bugfix: Fixed an issue where floating breaks ending after their maxEndTime were not correctly penalized. More details.
- Minutes between shifts fix: We have fixed a bug that caused the constraints to ignore the minutes between shifts rule in some cases. More details.
new
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Configure runtime architecture and several smaller improvements (v0.43.0)
- Ability to configure machine type to run the solving operations: When you set-up a configuration profile, you can now also apply extra scheduling policy labels that let you choose between running solve operations on AMD64 or ARM64 architecture. Configure specific machine types to find the best runtime for your type of dataset and learn which one yields better results.

- We have improved the Maps service documentation with more detailed information on availability of maps.
- Several smaller improvements (including logging more relevant data in the Audit log, more clearly indicating configuration parameter precedence when doing a new run, more clearly indicating for which models API keys can be used, and showing score analysis details when all constraints are satisfied, showing icons for constraint groups) and bugfixes (including returning the right better response headers for Recommendation API calls for non-existing runs).
- Icons for constraint groups: The score analysis and configuration profiles UI have been updated with icons for each of the constraint groups to help make each of the model features more clear.

- We have added documentation that explains how to handle long-running visits.
- We have made several smaller bugfixes (to the visualization in the platform) and improvements (like not showing the Visit SLA metric if no SLA information is provided).
- Icons for constraint groups: The score analysis and configuration profiles UI have been updated with icons for each of the constraint groups to help make each of the model features more clear.

- We have made several smaller bugfixes (to the visualization in the platform and we fixed a bug that caused the solver to not respect the shift rotation constraints in some edge cases).
new
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Visit SLA’s, technician ratings support for FSR, FTE support for ESS (v0.42.1)
- (For self-hosted installations only:)OIDC configuration now requires valid OIDC setup: When using OpenID connect, make sure you have valid OIDC configuration, else explicitly disable it as per the updated “Installation instructions”.
- Filter on Configuration Profile via Platform UI: It’s now possible to filter the runs overview of your models by the configuration profile that was used. On the overview, click “Add filter”, and choose “Configuration profile”. We’ve also added Configuration profile as one of the possible columns for your overview. Click on the three dots at the end of the header of the table to choose which columns you want to view.


- Ability to define SLA's for visits: Often visits not only have time windows describing the general availability of the location, but they also have a preferred time for when the task of the visit should be finished, often referred to as a Service Level Agreement (SLA). More information can be found in the feature guide for Visit SLAs.
- Ability to prefer picking technicians with higher ratings: We have added a new feature that allows you to specify the rating of each technician based on feedback from previous visits. Technicians can be assigned to visits based on their ratings where technicians with the highest ratings are more likely to be assigned. Learn more in the Technician ratings feature guide.
- Ability to exclude technicians/vehicles for certain visits: We have added the possibility to prohibit vehicles from being assigned to a visit. You can specify this in the visit'sprohibitedVehiclesattribute when submitting a new route-plan. See Prohibited vehicles in the Visit requirements guide.
- Several smaller bugfixes, see “New and noteworthy”.
- Allow to define employee min/max by FTE: We have added support for full-time equivalent (FTE) configuration in employee contracts, enabling fair scheduling for employees with different employment types. This feature allows you to define part-time, full-time, and other employment arrangements while ensuring fair distribution of work. The “balance time worked” constraint now automatically adjusts for different FTE levels, so a part-time employee (FTE 0.5) working 20 hours is considered equivalent to a full-time employee (FTE 1.0) working 40 hours. See “New and noteworthy” for details.
- Extended support for weekend constraints for rolling windows: We have extended our weekend constraints support with the ability to limit weekend work in rolling windows. You can now additionally express rules such as: “Maximum 2 weekends worked in any 4-week rolling window” or “Maximum 4 weekends worked in any 16-week rolling window”. This complements our existing weekend constraints for fixed periods, giving you more options for creating employee-friendly schedules. See “New and noteworthy” for details.
- A small bugfix related to the solver not terminating properly in corner cases.
new
improved
fixed
Timefold Platform
Employee Shift Scheduling
Field Service Routing
Audit log visibility via Platform UI, contract rules around weekends for ESS (v0.41.2)
- Audit log: We have added the ability to see the audit log of changes made to your tenant via the Platform’s UI. Anytime a user is added or removed, anytime a webhook is created or changed, or other configuration changes, information about this change is logged to the Audit Log. By going to your Tenant Settings, and choosing “Audit Log” in the sidebar, you are now able to see those changes. The UI supports filtering for certain types of event, Actor, IP and date.

- Ordering of metrics on Run Overview: It’s now possible to define the order of the columns when seeing the run overview of your model. You can pick from input and output metrics, as well as run data, and decide which information you want to see, and in what order. This change makes it easier for you to compare those metrics between runs you care most about. On the Runs Overview, click the dots at the end of the header row.
- Support for multiple vehicle types: We now have support for multiple vehicle types in our Maps service: cars, bicycles, and walking. We have set up a bicycle map for Georgia, USA as a demo - please contact us if you have specific requests for new maps with other vehicle profiles. We have also improved our documentation of the maps service.
- We have a bugfix for a potential score corruption with Balance movable and non-movable visits constraint.
- Ability to define contract rules around weekends: We have added support for weekend-related constraints, allowing you to limit weekend work for employees. These constraints help enforce restrictions on weekend work, which is important for maintaining employee work-life balance. You can: Limit the total minutes an employee works during weekends in a period. Limit the number of weekends an employee works in a period. Limit the number of consecutive weekends an employee works. See "New and noteworthy" for details.