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

# Managing Projects

Projects are the organizational backbone of Amnify Deploy. This guide covers how to create, edit, and navigate your projects effectively.

***

## Creating a Project

1. Navigate to **Deploy** in the Amnify platform

2. Select the cloud provider this project is associated with (Azure, AWS, or GCP)

3. Click **New Project**

4. Fill in the project details:

   | Field           | Required | Description                                                                    |
   | --------------- | -------- | ------------------------------------------------------------------------------ |
   | **Name**        | Yes      | A short, recognizable name (e.g., "Platform Team — Prod")                      |
   | **Description** | No       | A longer explanation of the project's purpose                                  |
   | **Tags**        | No       | Key–value pairs for categorization (e.g., `team: platform`, `env: production`) |

5. Click **Create Project**

The project is created immediately and you are taken to the project detail page.

***

## Editing a Project

You can update a project's name, description, and tags at any time. Editing a project does not affect its deployments.

1. Open the project you want to edit
2. Click the **Edit** button (or the settings icon) on the project detail page
3. Update the fields as needed
4. Save your changes

***

## Adding Tags

Tags are key–value pairs that help you categorize and filter projects. The examples below show a common `key: value` convention — this is not a required format, just a readable one. Use whatever tag format works for your organization.

**By environment:**

```
env: production
env: staging
env: development
```

**By team or owner:**

```
team: platform
owner: data-engineering
```

**By cost center:**

```
cost-center: engineering
budget-code: PLAT-2024
```

Consistent tagging across projects makes filtering and reporting much easier.

***

## Viewing Deployments in a Project

From the project detail page, you can see all Deployments that belong to the project, including their name and description, current status (active, never executed, failed, etc.), and when they were last executed.

Click on any Deployment to open its detail page, where you can view run history, edit variables, or trigger a new run.

***

## Searching and Filtering Projects

On the main Deploy dashboard (per cloud provider), you can:

* **Search** by project name or description using the search bar
* **Filter** by tags to narrow down projects belonging to a specific team or environment
* **Sort** by creation date or name

***

## Organizing Projects at Scale

As your use of Amnify Deploy grows, keeping projects organized becomes more important. Recommended practices:

* **Use consistent naming conventions** — for example, `[Team] — [Environment]` or `[Product] — [Region]`
* **Always fill in descriptions** — a clear description helps teammates quickly understand what a project is for
* **Tag consistently** — agree on a tagging schema across your organization and apply it to every project
* **Clean up unused projects** — delete projects that are no longer needed to keep the dashboard uncluttered

***

## Deleting a Project

<Warning>
  Before deleting a project, make sure all its Deployments have been destroyed and you no longer need them. Deleting a project does not automatically destroy the cloud resources — you must destroy each Deployment separately first.
</Warning>

To delete a project:

1. Open the project detail page
2. Destroy all Deployments within the project (if not already done)
3. Click **Delete Project**
4. Confirm the deletion

***

## Next Steps

* [Using Templates](/cspm-deploy/guides/using-templates) — find and use templates to create your first deployment
* [Creating Deployments](/cspm-deploy/guides/creating-deployments) — step-by-step deployment creation walkthrough