Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
    • Pick-up and Delivery Routing
    • Task Scheduling
  • Platform
Start Free Trial
  • Timefold Platform
  • How-tos
  • Manage organization
  • Tenant type and model release lag

Timefold Platform

  • Basics
    • Introduction
    • Getting started
    • Scheduling API concepts
    • Platform concepts
    • Available models
      • Model catalog and documentation
      • Model maturity and versioning
      • Trialing Timefold models
      • Bring your own model
  • How-tos
    • Model and dataset management
      • Dataset lifecycle
      • Dataset details
      • Datasets overview
      • Dataset revisions with /from-patch
      • Configuration profiles and parameters
      • Maps service
    • Analyze
      • Insights
      • Comparisons
      • Experiments
      • Timefold Copilot
    • Manage organization
      • General
      • Members
      • Tenants
      • Tenant type and model release lag
    • Manage tenant
      • Details
      • API Keys
      • Secrets
      • Members
      • Models
      • Notifications
      • Solve queue
      • Audit log
    • Manage user
      • Personal access tokens
      • Command palette
    • Job-oriented guides
      • Balancing different optimization goals
      • Validating an optimized plan with Explainable AI
      • Uncovering inefficiencies in operational planning
      • Responding to disruptions with real-time planning
      • Designing better routing plans with (just enough) traffic awareness
  • API integration
    • Before you integrate
    • Model API usage
    • Receiving model API results
      • Webhooks
      • Server sent events (SSE)
      • Polling
    • Handling changes to your planning data
    • Integration scenarios
      • Multiple environments and clusters
      • Data residency requirements
      • Air-gapped environments
    • Platform API usage
  • More information
    • FAQs
      • Modeling your planning problem
      • Planning horizon and replanning
    • Changelog
    • Feature requests
    • Pricing plans and capabilities
    • Self-Hosted
      • Self-Hosted vs. Timefold Cloud Platform
      • Installation instructions
      • Upgrade instructions
      • Troubleshooting
    • Support
      • Contacting support
      • Platform status
      • Troubleshooting
    • Trust
      • Risk profile
      • Product security
      • Data security
      • Legal and privacy
      • AI legislation compliance
      • Trust center
Ask Claude Ask ChatGPT

Tenant type and model release lag

On the organization’s Tenant type page, organization admins set the model release lag per tenant type: whether the tenants of that type run the latest model release, or stay one or two releases behind. This is how you use staggered model releases.

To access the page, open the profile menu, select Organization settings, and select Tenant type. See Open Organization settings for who can open Organization settings.

Tenant types

Every tenant in an organization has a tenant type:

Tenant type Badge Purpose

Development

Dev

Working environment for building and debugging your integration.

Testing

Testing

Testing before release.

Production

Prod

Used by end users.

All users see the badge next to the organization’s tenants in the tenant switcher.

Model release lag

For each tenant type, select a Model release lag:

  • Latest: tenants run the latest release of each model.

  • 1 release behind: tenants stay one release behind the latest.

  • 2 releases behind: tenants stay two releases behind the latest.

The default is Latest for every tenant type. Your change is saved as soon as you select a value.

The setting applies to all tenants of that tenant type, and to new releases of models on the platform. Timefold keeps the three most recent releases of a model. If a model has fewer older releases than the setting asks for, the tenant runs the oldest available release.

To check which model version a tenant runs, see Model version visibility in the UI.

Recommended setup

Timefold recommends Testing on Latest and Production on 1 release behind: your Testing tenant gets each new release first, so you can validate it with your own datasets before your Production tenant runs the release. See Staggered model releases for a worked example with version numbers.

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