---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/it-service-management

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Tutorial: add a new change management state

# Tutorial: add a new change management state {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

This tutorial provides an example of adding a new state to the existing state
model.

## Antes de Iniciar

Role required: script_include_admin, ui_policy_admin, ui_action_admin, or admin

## Por Que e Quando Desempenhar Esta Tarefa

Consider the following scenario:

Based on your organization's requirements, you must add a new state, Complete, between the existing Implement and
Review states. You must also add the ability to decide if the Review state is needed.

Perform the following steps:

## Procedimento

Open the Change Request form.
1. [Create a new choice](https://servicenow-prod.fluidtopics.net/rZr1pnD4N4lpmXhRjmWi8Q)  
   Create a new choice for the change request state.
2. [Create a custom field](https://servicenow-prod.fluidtopics.net/3VQFQdQduHHSecaxciXtFw)  
   Create a custom choice field to indicate whether a change request must go through the Review state.
3. [Add a UI policy](https://servicenow-prod.fluidtopics.net/RasM4vZlmnmgoUbMtNrcXg)  
   Add a UI policy to display the Needs review field for Normal change requests when it reaches the Complete state.
4. [Create an ACL](https://servicenow-prod.fluidtopics.net/t6YR94JvEl7m7PnE1eOJ~A)  
   Create an access control rule (ACL) to prevent the Needs review field from being modified after it has been set.
5. [Update the state handler script include](https://servicenow-prod.fluidtopics.net/rRAwxOG9xTUO0ktpDPW57g)  
   Update the ChangeRequestStateHandler script include with the new Complete state.
6. [Update the state model script include](https://servicenow-prod.fluidtopics.net/68sVQ1A6_fNLBNI2ywZb7w)  
   Update the ChangeRequestStateModel_normal script include to add new functions for the Complete state.
7. [Create a UI action](https://servicenow-prod.fluidtopics.net/OPd3zgtfm1Iq20aGPr5jWQ)  
   Create a UI action to display a button on a change request for the Complete state.
8. [Create a process flow record](https://servicenow-prod.fluidtopics.net/QADK6acC23c7wWCrYb_Tog)  
   Create and add a process flow record for the Complete state. The process flow formatter displays at the top of the Change Request form.
9. [Update the change request workflow](https://servicenow-prod.fluidtopics.net/q6tmL1V13ZkXqWjsrcSwcQ)  
   Update the change request workflow to reflect the addition of the Complete state.