{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":31847,"path":"it-service-management/change-management/t_AddNewStateTutorial.md","title":null,"bundle":null,"doc_type":null,"release":null,"body":"---\ntitle: Tutorial: add a new change management state\ndescription: This tutorial provides an example of adding a new state to the existing state model.\nlocale: en-US\ncanonical_url: https://www.servicenow.com/docs/r/australia/it-service-management/change-management/t\\_AddNewStateTutorial.html\nrelease: australia\nproduct: Change Management\nclassification: change-management\ntopic_type: task\nlast_updated: \"2026-03-12\"\nreading_time_minutes: 1\nbreadcrumb: [Reference, Change Management, IT Service Management]\n---\n\n# Tutorial: add a new change management state\n\nThis tutorial provides an example of adding a new state to the existing state model.\n\n## Before you begin\n\nRole required: script\\_include\\_admin, ui\\_policy\\_admin, ui\\_action\\_admin, or admin\n\n## About this task\n\nConsider the following scenario:\n\nBased 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.\n\nPerform the following steps:\n\n## Procedure\n\n1.  Open the **Change Request** form.\n\n\n1.  [Create a new choice](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_CreateNewChoice.md)  \nCreate a new choice for the change request state.\n2.  [Create a custom field](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_CreateCustomField.md)  \nCreate a custom choice field to indicate whether a change request must go through the **Review** state.\n3.  [Add a UI policy](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_AddUIPolicy.md)  \nAdd a UI policy to display the **Needs review** field for **Normal** change requests when it reaches the **Complete** state.\n4.  [Create an ACL](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_CreateNewACL.md)  \nCreate an access control rule \\(ACL\\) to avoid the **Needs review** field from being modified after it has been set.\n5.  [Update the state handler script include](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_UpdateStateHandlerScriptInclude.md)  \nUpdate the ChangeRequestStateHandler script include with the new **Complete** state.\n6.  [Update the state model script include](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_UpdateStateModelScriptInclude.md)  \nUpdate the ChangeRequestStateModel\\_normal script include to add new functions for the **Complete** state.\n7.  [Create a UI action](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_CreateNewUIAction.md)  \nCreate a UI action to display a button on a change request for the **Complete** state.\n8.  [Create a process flow record](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_CreateNewProcessFlowRecord.md)  \nCreate and add a process flow record for the **Complete** state. The process flow formatter displays at the top of the Change Request form.\n9.  [Update the change request workflow](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/t_UpdateWorkflow.md)  \nUpdate the change request workflow to reflect the addition of the **Complete** state.\n\n**Parent Topic:**[Reference section for Change Management](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/change-management/reference-change-management.md)\n\n"}}