> ## Documentation Index
> Fetch the complete documentation index at: https://vms.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use templates in the app

> Find the templates of your workspace on the Templates page, create a sandbox from a template, share it with a code, and rename or delete one or many templates.

The **Templates** page shows the templates of your workspace. Create a sandbox from a template, share it with another workspace, and rename or delete templates without the API.

## Before you start

* Each role (**Owner**, **Admin**, and **Member**) can see, rename, share, and delete the templates of the workspace, and create sandboxes from them.
* To save a template, open a sandbox on the **Sandboxes** page and choose **Save as template**. See [Save a sandbox as a template](https://vms.dev/docs/sandboxes/in-the-app.md#save-a-sandbox-as-a-template).

## Find a template

In the sidebar, under **VMS**, choose **Templates**.

The table shows the **Name**, the **Status**, the **Size**, the **Stored** size, and the **Created** date of each template.

* **Saving** shows while the template takes a snapshot of its sandbox. **Ready** shows when you can create sandboxes from it. **Failed** shows when the save did not complete. The sheet of a failed template shows why.
* The **Size** is the size of the sandbox at the save. The **Stored** size is the compressed size of the files.
* To find a template, type its name or its ID in **Search templates**.
* To show only the templates with a status, use the **Status** filter.
* To sort the table, choose a column header.
* To show the **Ready** column, choose the gear at the right of the table.

The table updates by itself. A template that you save, rename, or delete with the API, the CLI, the SDK, or an agent shows at once, with no page reload. The codes in the **Share codes** tab also update by themselves. If the sheet of a template is open when the template is deleted, the sheet shows **This template was deleted.**

![The Templates page with three templates: one Saving, one Failed, and one Ready.](https://mintcdn.com/vms-c6f4e5ac/kvsBm-leIVQYZQAw/images/sandboxes/templates-in-the-app/00-templates-page-light.png?fit=max\&auto=format\&n=kvsBm-leIVQYZQAw\&q=85\&s=f68c2df444e4b0d38456eadaac84f711)

## See the details of a template

Choose the row of the template, or open its menu (**...**) and choose **View details**. A wide sheet opens. Its top shows the name and the ID of the template, and the actions: **Create sandbox** (for a **Ready** template), **Rename**, and **Delete**. On a small screen, the actions are in the menu (**...**) at the top.

The column at the right of the sheet shows the facts of the template. On a small screen, the facts are below the tabs.

| Fact | Content |
| - | - |
| **Status** | **Saving**, **Ready**, or **Failed**. |
| **Size** | The size of the sandbox at the save. |
| **Stored** | The compressed size of the files. |
| **Saved from** | The ID of the sandbox that you saved the template from. Choose it to open the sheet of that sandbox. |
| **Created** and **Ready** | The time of the save and the time that the template became ready. |

The **Overview** tab shows why a failed save did not complete, and the vCPUs, the RAM, and the disk of the size. A **Ready** template also has the **Share codes** tab. See [Share a template with another workspace](#share-a-template-with-another-workspace).

The URL holds the open template and its tab. A reload keeps them.

## Create a sandbox from a template

1. Open the menu (**...**) of a **Ready** template and choose **Create sandbox**. Or open the template and choose **Create sandbox**.
2. Optional: type a **Name**.
3. Choose a **Size**. The default is the size of the template.
4. Choose **Create sandbox**.

The **Sandboxes** page opens with the sheet of the new sandbox. The sandbox starts with the files of the template. See [Create a sandbox from a template](https://vms.dev/docs/sandboxes/templates.md#create-a-sandbox-from-a-template).

## Share a template with another workspace

Open a **Ready** template and choose the **Share codes** tab. The tab lists the codes of the template. See [Share a template with another workspace](https://vms.dev/docs/sandboxes/templates.md#share-a-template-with-another-workspace).

1. Optional: type a label, such as the name of the team that gets the code.
2. Choose **Create code**.
3. Copy the code. You cannot see it again.

![The sheet of a Ready template: its name and ID with the Create sandbox, Rename, and Delete buttons, the Overview and Share codes tabs, and a column of facts on the right.](https://mintcdn.com/vms-c6f4e5ac/kvsBm-leIVQYZQAw/images/sandboxes/templates-in-the-app/01-template-sheet-light.png?fit=max\&auto=format\&n=kvsBm-leIVQYZQAw\&q=85\&s=83b0a39fccbe1b8f233e23c1c16dae6a)

To revoke a code, open the menu (**...**) of its row, choose **Revoke**, then **Revoke code**. The code stops working at once. Sandboxes that started from the code stay.

## Rename or delete a template

Open the menu (**...**) of the row, or open the template and use the actions at the top of its sheet:

* Choose **Rename**, type the new name, then choose **Save**.
* Choose **Delete**, then **Delete template**. Sandboxes that started from the template stay. You cannot undo this.

## Delete many templates

1. Select the checkbox of each template.
2. Choose **Actions**.
3. Choose **Delete**, then confirm.

Read the [changelog.](https://vms.dev/docs/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.