# Workspace Templates

This section explains the procedure to manage templates.

A template is a pre-set configuration that is used to quickly configure and submit workloads using existing assets. A template consists of all the assets a workload needs, allowing researchers to submit a workload in a single click, or make subtle adjustments to differentiate them from each other.

## Workspace Templates Table

The Templates table can be found under **Workload manager** in the NVIDIA Run:ai User interface.

The Templates table provides a list of all the templates defined in the platform, and allows you to manage them.

{% hint style="info" %}
**Flexible management**

It is also possible to manage templates directly for a specific [user](/self-hosted/2.21/infrastructure-setup/authentication/users.md), [application](/self-hosted/2.21/infrastructure-setup/authentication/applications.md), [project](/self-hosted/2.21/platform-management/aiinitiatives/organization/projects.md), or [department](/self-hosted/2.21/platform-management/aiinitiatives/organization/departments.md).
{% endhint %}

![](/files/ZAhGEFf3FRfskhGZZa6h)

The Templates table consists of the following columns:

| Column           | Description                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| Scope            | The scope to which the subject has access. Click the name of the scope to see the scope and its subordinates |
| Environment      | The name of the environment related to the workspace template                                                |
| Compute resource | The name of the compute resource connected to the workspace template                                         |
| Data source(s)   | The name of the data source(s) connected to the workspace template                                           |
| Created by       | The subject that created the template                                                                        |
| Creation time    | The timestamp for when the template was created                                                              |
| Cluster          | The cluster name containing the template                                                                     |

### Customizing the Table View

* Filter - Click **ADD FILTER**, select the column to filter by, and enter the filter values
* Search - Click **SEARCH** and type the value to search by
* Sort - Click each column header to sort by
* Column selection - Click **COLUMNS** and select the columns to display in the table
* Download table - Click **MORE** and then click Download as CSV. Export to CSV is limited to 20,000 rows.
* Refresh (optional) - Click **REFRESH** to update the table with the latest data
* Show/Hide details (optional) - Click to view additional information on the selected row

## Adding a New Workspace Template

To add a new template:

1. Click **+NEW TEMPLATE**
2. Set the scope for the template
3. Enter a name for the template
4. Select the environment for your workload
5. Select the node resources needed to run your workload\
   \- or -\
   Click **+NEW COMPUTE RESOURCE**
6. Set the volume needed for your workload
7. Create a new data source
8. Set auto-deletion, annotations and labels, as required
9. Click **CREATE TEMPLATE**

## Copying a Template

To copy an existing template:

1. Select the template you want to copy
2. Click **MAKE A COPY**
3. Enter a **name** for the template. The name must be unique.
4. Update the template and click **CREATE TEMPLATE**

## Renaming a Template

To rename an existing template:

1. Select the template you want to rename
2. Click **Rename** and edit the name/description

## Deleting a Template

To delete a template:

1. Select the template you want to delete
2. Click **DELETE**
3. Confirm you want to delete the template

## Using API

Go to the [Workload template](https://run-ai-docs.nvidia.com/api/2.21/workload-assets/template) API reference to view the available actions.


---

# 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://run-ai-docs.nvidia.com/self-hosted/2.21/workloads-in-nvidia-run-ai/workload-templates/templates.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.