> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/projects.md).

# Projects

Group assets into projects and control who can see and change them.

A **project** groups assets and decides who can see and change them. Every asset belongs to one project, and access is granted per project. See [Role-based access](/telmai/authentication-and-access-control.md#role-based-access).

Within a project, you can organize assets into folders, up to three levels deep. See [Managing Assets](/telmai/connect-to-data/managing-assets.md#the-asset-tree).

## Manage projects

Tenant admins manage projects in **Administration** > **Projects**.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-53469831d5e1451dafe724543000388c16726f64%2Fmanage-projects-2026-11-04.png?alt=media" alt="The Projects setting listing projects with their IDs, descriptions, groups and assets"><figcaption><p>Projects in Administration.</p></figcaption></figure>

The list shows each project's ID, name, description, and how many groups and assets it holds. Use **Search by name or description** to find a project.

### Create a project

1. Click **New project**.
2. Enter a **Project name** and, optionally, a **Description**.
3. Optionally, add **Infra tags**: labels applied to the compute clusters that run the project's scans. They are useful for cost tracking and resource grouping in your cloud provider.
4. Click **Create**.

### Edit or delete a project

* Click a project to open **Edit project** and change its name, description or infra tags, then click **Save**.
* Click **Delete** in a project's row to delete it. Only empty projects can be deleted, so move or delete their assets first.

## Move assets to another project

1. Open **Assets** and click **Manage** at the top of the asset tree.
2. Select the assets to move, up to 10 at a time, and click **Move**.
3. In **Move assets**, choose the **Target project** and, optionally, a **Folder** in it (or **New folder…**), and confirm.

You can also drag assets in the tree while managing. To move a group of assets, use **Move** in the group's **⋯** menu.

{% hint style="info" %}
Monitors move with their assets, except monitors created from a rule template.
{% endhint %}
