---
title: Change requests
slug: ryze/change-requests
description: Learn how to effectively manage change request templates with this comprehensive document. From creating and editing templates to activating and deleting them, this guide covers it all. Discover how to add and filter properties, along with editing and fil
createdAt: 2023-08-31T14:12:13.691Z
---

Change requests are used to track change within a standard or study through a predefined workflow. You can define as many change request templates as you want, each with their own properties and lifecycle states. Your workflow can be as simple or as complex as required.

Creating a change request template with properties and states can be carried out in the following order:

1. Create template.
2. Add workflow states.
3. Set transitions for each workflow state. 
4. Set Initial state.
5. Activate template.

Change request templates can be in one of three of the following states:

- Template ready for use
- Template requires activation. See Activating a template.
- Template invalid. See Making initial state. If the Workflow is invalid, see Adding a state to a change request template

### Creating a change request template

To create a change request template:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change requests** tab.
3. Select **Create template**.
4. Enter the **Name** and select the **Context**.
5. Select **Save**.

Change request contexts:

**None&#xA0;**- Not related to specific standards, studies or assets

**Standards&#xA0;**- Related to specific standards

**Studies&#xA0;**- Related to specific studies

**Standards and studies&#xA0;**- Related to specific standards and studies

**Standard assets** - Related to specific assets within a standard

**Study assets&#xA0;**- Related to specific assets within a study

**Standard and study assets** - Related to specific assets within a standard or study&#x20;

### Editing a template

To edit a change request template:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change requests** tab.
3. Select the options icon next to the change request template you want to edit and select **Edit template**.
4. Edit the template as required.
5. Select **Update**.

You cannot edit a template after it has been activated.

### Cloning a template

To clone a change request template:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change request** tab.

Select the options icon next to the change request template you want to clone and select **Clone template**. The cloned change request template appears in the list with (CLONE) after its name.

### Activating a template

You can activate as many change request templates as you wish.

To activate a change request template:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change request** tab.
3. Select the options icon next to the change request template you want to activate and select **Activate template**.
4. Select **Activate**.

  You must set one of the states within a change request template to **"initial state"** or else that template is invalid.

### Deleting a template

To delete a change request template:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change request** tab.
3. Select the options icon next to the change request template you want to delete and select **Delete template**.
4. Select **Delete**.

  You can delete a template after it has been activated but you cannot edit it.

### Adding properties to change request templates

You can define properties for change requests.

The types of custom properties are:

- Text
- Note
- Number
- Date Time
- Select - use this to add a number of options to a custom property, for example, situations where a choice or multiple answers are applicable.

You can add a custom property if the change request template has not been activated.

To add a custom property:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change request** tab.
3. Select the options icon next to **Properties** and select **Add**.
4. Enter the **Name** and select **Type** from the dropdown list.
5. (Optional) Select the **Mandatory** check box to make the property mandatory.
6. Select **Save**.

Custom property - Select available options

You can include a property that has a number of options to pick from. You can allow users to choose one option for selection or allow multiple options to be selected.

To do this:

1. Enter the **Name** and select **Type = Select** from the dropdown list.
2. (Optional) Select the **Mandatory** check box to make the property mandatory.
3. (Optional) Enter an **Available option** and press **return** on your keyboard. Repeat this step until you have entered all the available options required.
4. (Optional) Select **Multiselect** so that more than one option can be selected.

**To remove available options:**

- Select the delete icon next to the available option you wish to remove.

**To edit a custom property:**

Select the edit icon next to the custom property you want to edit.

1. (Optional) You can update the **Name** and **Type**.
2. Select if the custom property is to be **Mandatory**.
3. Select **Save**.

**To remove a custom property:**

- Select the delete icon next to the custom property you wish to remove.

### Filtering properties

You can filter properties for change requests:

To filter properties:

1. Select the options icon next to **Properties**.
2. Enter the properties you want to filter in the **Filter properties** text box.

 To remove a filter:

- Select the cross icon next to the filter you wish to remove above the search results.

### Adding a state to a change request template

You can define the workflow states for a change request template.

To add a state:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change request** tab.
3. Select the options icon next to **Workflow** and select **Add**.
4. Enter the **Name** and select a **Category**.
5. (Optional) Enter a label name into **List of approvers** and press return. This label can then be assigned to a user, see Transitioning the workflow. You can enter more than one label to assign approvers to.
6. (Optional) Select **Can transition to** from the list. You may not be able to set "Can transition to" until all states have been added. If this is the case see Editing a state.
7. Select **Save**.

If you add more than one approver, it will not be possible for the change request state to be transitioned until each approver has approved the change request.

### Editing a state

You can edit a state for a workflow:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change request** tab.
3. Select the options icon next to **Workflow**.
4. Select the options icon next to the workflow state you want to edit and select **Edit state**.
5. (Mandatory) You can update the **Name** and **Category**.
6. (Optional) You can enter labels for approvers, then select return on your keyboard. Examples of labels could be Quality Assurance, Test, Development etc. These can then be assigned to users in change requests. See Transitioning the workflow.
7. (Optional) You can select which state or states this state can transition by selecting from the drop down list.
8. (Optional) If you have added a label to the list of approvers, you can select the **Requires approval** check box. This means that approval must be granted before a transition to the next state is allowed.
9. Select **Update**.

To remove a transition for a state:

- Select the trash icon next to the transition you want to delete.

### Making initial state

You can set the initial state of the workflow in a change request template. You can add, edit and delete workflow states after the initial state has been set.

To set an initial state:

1. Select the options icon next to **Workflow**.
2. Select **Make initial state**.

  If the initial state is not set, the change request template is invalid and cannot be activated.

### Filtering states

You can filter states in the workflow.

To filter states:

1. Select the options icon next to **Workflow**.
2. Enter the states you want to filter in the **Filter states** text box.

 To remove a filter:

- Select the cross icon next to the filter you wish to remove above the search results.

### Deleting a state

To delete a state:

1. Select **Admin** from the **Navigation** bar and select **Repository**.
2. Select the **Change request** tab.
3. Select the options icon next to the change request template you want to delete and select **Delete template**.
4. Select **Delete**.



