# Using template versions

Template versions allow you to safely test changes on your hosts and perform rollback if necessary.

### Supported providers

Template versions are supported for the following providers:

Hypervisor Providers:

* Microsoft Hyper-V
* Microsoft Hyper-V Failover Cluster
* VMware ESXi
* VMware VCenter

Cloud Providers:

* Microsoft Azure

Virtualization services:

* Azure Virtual Desktop

### Creating a new version

To create a new version:

1. Do one of the following:
   * To create a new version for an RD Session Host template, navigate to **Farm > Site > RD Session Hosts > Templates**.
   * To create a new version for a VDI host template, navigate to **Farm > Site > VDI > Templates**.
   * To create a new version for an AVD host template, navigate to **Farm > Site > Azure Virtual Desktop > Templates**.
2. Select the template, enter the maintenance mode, make changes and exit. You will see a dialog that prompts you to create a new template version. Select the **Create a new version** option.\
   \
   **Note:** One template can have up to five versions. If you want to create another version, you will have to delete an already existing one.
3. Click **Next**.
4. On the **New template version** page, specify the name and description and select the tags for the version. If the tag was previously assigned to another version, it will be removed from this version. You can select several tags.
5. Click **Next**.
6. (Optional) On the **Select host pools** page, select the host pools that you want to recreate on schedule and click the **Configure** button. You will see a dialog that allows you to schedule recreation. Configure the schedule according to your needs and click **Next**.
7. Click **Finish**.

### Working with version tags

To rename a tag:

1. Navigate to **Farm > Site > Settings** and select **Template versions** tab.
2. Double-click the tag that you want to rename.
3. Change the name of the tag and press Enter.

To reassign tags of a version:

1. Do one of the following:
   * To reassign tags for RD Session Host template, navigate to **Farm > Site > RD Session Hosts > Templates**.
   * To reassign tags for a VDI host template, navigate to **Farm > Site > VDI > Templates**.
   * To reassign tags for an AVD host template, navigate to **Farm > Site > VDI > Azure Virtual Desktop > Templates**.
2. Select a template and click **Tasks > Versions**. The **Versions** dialog opens.
3. Select a version and click **Tasks > Properties**.
4. In the **Version tag** section, select the tags that you need. If the tag was previously assigned to another version, it will be removed from this version. You can assign several tags to a version. If another host pool uses the same version with the same tags, you will see a dialog that allows you to recreate hosts in that host pool.

### Deleting a version

To delete a version:

1. Do one of the following:
   * To delete a version of an RD Session Host template, navigate to **Farm > Site > RD Session Hosts > Templates**.
   * To delete a version of a VDI host template, navigate to **Farm > Site > VDI > Templates**.
   * To delete a version of an AVD host template, navigate to **Farm > Site > VDI > Azure Virtual Desktop > Templates**.
2. Select a template and click **Tasks > Versions**. The **Versions** dialog opens.
3. Select a version and click **Tasks > Delete**.

### Settings audit

Settings audit allows you to see recent changes to versions.

To see settings audit:

1. Do one of the following:
   * For RD Session Host template version settings audit, navigate to **Farm > Site > RD Session Hosts > Templates**.
   * For a VDI template version settings audit, navigate to **Farm > Site > VDI > Templates**.
   * For an AVD template version settings audit, navigate to **Farm > Site > VDI > Azure Virtual Desktop > Templates**.
2. Select a template and click **Tasks > Versions**. The **Versions** dialog opens.
3. Select a version and click **Tasks > Settings audit**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parallels.com/landing/ras-admin-guide/parallels-ras-21-administrators-guide/common-management-tasks/using-template-versions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.