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

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

Manage organization

An organization groups one company’s tenants on Timefold Platform. The organization holds a set of tenants with a clear tenant type (Production, Testing, or Development), and its own members who manage the organization.

Organizations are available on Timefold Cloud. Timefold sets up the organization together with you.

Why use an organization

Consistent environments from the start

Your Production, Testing, and Development tenants are created together, with consistent names. Every tenant shows its tenant type (Prod, Testing, or Dev) in the tenant switcher, so you always know whether you’re working in production.

Control when new model releases reach production

Set a model release lag per tenant type: tenants run the latest model release, or stay one or two releases behind. For example, validate a new release in your Testing tenant while your Production tenant stays on the previous release. You set this yourself, without contacting Timefold. See Tenant type and model release lag.

Central administration

Organization admins manage the organization’s members and tenants in one place, under Organization settings.

Add Production tenants yourself

With a setup that includes multiple Production tenants, organization admins add Production tenants without contacting Timefold. This is useful when you run one Production tenant per end customer, for example as an OEM.

A namespace for your own models

If custom models are enabled for your organization, model admins register your own models under the organization’s namespace. See Bring your own model.

How an organization is structured

An organization holds its organization members and the model release lag per tenant type
Figure 1. An organization with a Production, a Testing, and a Development tenant
  • The model release lag is set per tenant type and applies to every tenant of that type.

  • Organization members are organization admins and model admins. They’re separate from the members of each tenant.

  • Each tenant keeps its own members, models, datasets, API keys, and configuration profiles, isolated from the other tenants.

An organization exists in one Timefold Platform region (EU or US).

Tenant setups

When Timefold creates your organization, you choose a tenant setup together. The setup decides which tenants the organization has.

Tenant setup Tenants Organization admins can add tenants

Production only

One Production tenant

No

Testing and Production

One Testing and one Production tenant

No

Development, Testing, and Production

One Development, one Testing, and one Production tenant

No

Testing and multiple Production

One Testing tenant and one or more Production tenants

Yes, Production tenants up to the organization’s maximum

Development, Testing, and multiple Production

One Development tenant, one Testing tenant, and one or more Production tenants

Yes, Production tenants up to the organization’s maximum

Each organization has at most one Testing tenant and one Development tenant.

The tenants are named after the organization. For an organization named Acme, the tenants are Acme (Production), Acme - Testing, and Acme - Dev. You can rename tenants on each tenant’s Details page.

To change your tenant setup, contact Timefold.

Roles

Organization roles and tenant roles are separate.

  • Organization admin: manages the organization’s members, tenants, and model release lag under Organization settings.

  • Model admin: registers custom models under the organization’s namespace. Available when custom models are enabled for the organization.

  • Tenant roles (Administrator, User, and Viewer): apply to a single tenant. See Members.

A person can have both an organization role and a tenant role. To open Organization settings, an organization admin must be a member of at least one of the organization’s tenants. To register custom models, a model admin must be a member of a tenant in the organization. To work with a tenant’s models and datasets, or to manage a tenant, you need a tenant role on that tenant.

See What each role can do for a comparison of organization and tenant roles.

Open Organization settings

  1. Log in to https://app.timefold.ai.

  2. In the tenant switcher in the header, select one of the organization’s tenants.

  3. Open the profile menu by clicking the cogwheel in the top-right corner of the header.

  4. Select Organization settings.

Organization settings opens for the organization of the selected tenant. The profile menu only shows Organization settings to organization admins of the selected tenant’s organization. Model admins and tenant members don’t see Organization settings in the profile menu. To open Organization settings, an organization admin must be a member of at least one of the organization’s tenants.

Changes that require Timefold

Contact Timefold to:

  • Change the organization’s plan, name, or company.

  • Change the tenant setup, or add a Testing or Development tenant.

  • Change the maximum number of users or Production tenants.

  • Change maps settings.

  • Enable or disable custom models.

  • Remove a tenant from the organization, or move it to another organization.

  • Delete the organization.

FAQ

How do I get an organization?

Contact Timefold. Timefold creates the organization with you, including the plan and the tenant setup.

Are organizations available on self-hosted installations?

No. Organizations are only available on Timefold Cloud.

Why can’t I open Organization settings?

The profile menu only shows Organization settings if you’re an organization admin and the tenant selected in the tenant switcher belongs to the organization. If you’re not an organization admin, ask an organization admin to invite you as organization admin. If you’re not a member of any of the organization’s tenants, ask an organization admin to invite you to one of the organization’s tenants.

I’m an organization admin of several organizations. Which organization do I manage?

Organization settings opens for the organization of the tenant selected in the tenant switcher. Select a tenant of the organization you want to manage, then open the profile menu and select Organization settings.

Does inviting someone as organization admin give them access to the tenants?

No. They can manage the organization, but to work with a tenant’s models and datasets they need a tenant role on that tenant. Invite them separately on each tenant’s Members page with the tenant role they need. Tenants created for the organization, including new Production tenants, get the organization’s active organization admins and model admins as Administrators. Someone you invite is only added to tenants created after they accept the invite.

Does removing someone from the organization remove them from its tenants?

No. Remove them from each tenant’s Members page as well.

Can a tenant in an organization have its own plan?

No. The organization’s plan applies to every tenant in it.

Can I add a second Testing or Development tenant?

No. An organization has at most one Testing tenant and one Development tenant. Only setups with multiple Production tenants let organization admins add tenants, and only Production tenants.

Can an organization include tenants in both the EU and the US?

No. An organization exists in one region.

Can I use a tenant without an organization?

Yes. An organization is optional. A tenant without an organization works as described in Manage tenant, with its own plan and without a tenant type.

Organization settings pages

  • General

  • Members

  • Tenants

  • Tenant type and model release lag

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