Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure change model states

Configure states for change models and define transition between multiple states.

Before you begin

The change model for which you want to define the states should already exist. For more information, see Create a Change model.

Role required: change_manager

Procedure

  1. Navigate to All > Change > Administration > Change Models.

  2. Select the change model for which you want to define states.

  3. Navigate to Model States.

  4. Select New.

  5. On the form, fill in the fields.

    FieldDescription
    StateState that you want to include in your model.
    Initial StateOption to enable this state as the initial state for your model. This field is automatically selected when you add the first state to your model.
  6. Save the state and return to the Change Model form by selecting Submit.

  7. Add a transition between the available states by selecting the display/hide hierarchical lists icon (

Image omitted: display-hide-hierarchial-lists.png
\) for the model state that you want to apply the transition to.
1.  Select **New**.

    The Model State Transitions page is displayed.

2.  On the form, fill in the fields.

    |Field|Description|
    |-----|-----------|
    |From|State that the change request is moving from.|
    |To|State that the change request is moving to.|
    |Automatic Transition|Option for enabling automatic transition to the change request when the defined conditions are met. Selecting this option also helps prevent you from manually selecting the **State** field on the change request form.|

3.  Select the form context menu icon \(
Image omitted: form-context-menu.png
\) and select **Save**.
4.  Select **New** to add conditions for transition between states.

5.  On the form, fill in the fields.
FieldDescription
NameUnique name for the condition.
State TransitionThis field is automatically set to the state that you're applying the condition to.
DescriptionDetailed description of the condition.
Requires

Condition for your transition.The available options are:

  • Mandatory Fields:Requires specified fields to be populated before the model state transitions.
  • Transition Condition: Enables you to define a more granular condition.

For more information, see Create predefined conditions.

Condition \(condition builder\)Condition that must be fulfilled to enable the state transition.This field is available only when Transition Condition is selected from Requires field.
Condition \(script\)Script that must be fulfilled to enable the transition. The script returns a value of True when passed.
ActiveOption to make the condition active.
6.  Select **Save**.

What to do next

Attach a process with defined conditions that enable transition between change model states. See Attach a process for Change model states.

Create change templates based on the change model. For more information, see Create and propose a change template.

Parent Topic:Create a Change model