--- title: Managing projects product: vercel url: /docs/projects/managing-projects canonical_url: "https://vercel.com/docs/projects/managing-projects" last_updated: 2026-02-26 type: how-to prerequisites: - /docs/projects related: - /docs/project-configuration/project-settings - /docs/deployments/managing-deployments - /docs/rbac/access-roles - /docs/rbac/access-roles/extended-permissions - /docs/git summary: Learn how to manage your projects through the Vercel Dashboard. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Managing projects You can manage your project on Vercel in your project's dashboard. To learn more, see [Project Settings](/docs/project-configuration/project-settings) and [Managing deployments](/docs/deployments/managing-deployments). ## Related pages > **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below. - [How do I change the name of my Vercel Project?](https://vercel.com/kb/guide/how-do-i-change-the-name-of-my-vercel-project?from=related) — Change your Vercel project name in the dashboard, CLI, or REST API, then update the environment variables, callbacks, an - [How to protect your AI endpoints with Vercel BotID](https://vercel.com/kb/guide/protect-ai-endpoints-with-vercel-botid?from=related) — Gate every request to your AI endpoints with Vercel BotID and checkBotId\(\) so inference runs only for verified callers - [Deployments](https://vercel.com/docs/deployments?from=related) — Learn how to create and manage deployments on Vercel. - [Reference](https://vercel.com/docs/platforms/multi-project-platforms/reference?from=related) — API reference, error codes, troubleshooting, and FAQ for multi-project platforms on Vercel. - [Global Configs & Dashboard](https://vercel.com/docs/global-config/global-config-dashboard?from=related) — Learn how to create, view and update your Global Configs and the data inside them in your Vercel Dashboard at the Hobby - [Delete a Project](https://vercel.com/docs/rest-api/projects/delete-a-project?from=related) - [Deploy from CLI](https://vercel.com/docs/projects/deploy-from-cli?from=related) — Set up and deploy a Vercel project using the CLI, from linking to production. Full cross-link map for this page: [/docs/projects/managing-projects.graph.md](/docs/projects/managing-projects.graph.md) ## Creating a project > **💡 Note:** To create a project, you need an [Owner](/docs/rbac/access-roles#owner-role) or [Member](/docs/rbac/access-roles#member-role) role. If you have a [Developer](/docs/rbac/access-roles#developer-role) role, you'll need the [Create Project](/docs/rbac/access-roles/extended-permissions#create-project) extended permission. For more information, see [Access Roles](/docs/rbac/access-roles). #### \['Dashboard' To create a [new](/new) project: 1. On the Vercel [dashboard](https://vercel.com/d?to=%2Fdashboard\&title=Open+Dashboard), ensure you have selected the correct team from the team switcher. 2. Click the **Add New…** drop-down button and select **Project**: ![Image](`/docs-assets/static/docs/concepts/projects/add-new-project-light.png`) 3. You can either [import from an existing Git repository](/docs/git) or use one of our [templates](/templates). For more information, see our [Getting Started with Vercel](/docs/getting-started-with-vercel). 4. If you choose to import from a Git repository, you'll be prompted to select the repository you want to deploy. 5. Configure your project settings, such as the name, [framework](/docs/frameworks), [environment variables](/docs/environment-variables), and [build and output settings](/docs/builds/configure-a-build#configuring-a-build). 6. If you're importing from a monorepo, select the **Edit** button to select the project from the repository you want to deploy. For more information, see [Monorepos](/docs/monorepos#add-a-monorepo-through-the-vercel-dashboard). #### 'cURL' To create an Authorization Bearer token, see the [access token](/docs/rest-api#creating-an-access-token) section of the API documentation. ```bash filename="cURL" curl --request POST \ --url https://api.vercel.com/v11/projects \ --header "Authorization: Bearer $VERCEL_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "environmentVariables": [ { "key": "", "target": "production", "gitBranch": "", "type": "system", "value": "" } ], "framework": "", "gitRepository": { "repo": "", "type": "github" }, "installCommand": "", "name": "", "rootDirectory": "" }' ``` #### 'SDK'] To create an Authorization Bearer token, see the [access token](/docs/rest-api#creating-an-access-token) section of the API documentation. ```ts filename="createProject" import { Vercel } from '@vercel/sdk'; const vercel = new Vercel({ bearerToken: '', }); async function run() { const result = await vercel.projects.createProject({ requestBody: { name: '', environmentVariables: [ { key: '', target: 'production', gitBranch: '', type: 'system', value: '', }, ], framework: '', gitRepository: { repo: '', type: 'github', }, installCommand: '', name: '', rootDirectory: '', }, }); // Handle the result console.log(result); } run(); ``` ## Pausing a project You can choose to temporarily pause a project to ensure that you do not incur usage from [metered resources](/docs/limits#additional-resources) on your production deployment. ### Pausing a project when you reach your spend amount To automatically pause your projects when you reach your spend amount: 1. On the Vercel [dashboard](https://vercel.com/d?to=%2Fdashboard\&title=Open+Dashboard), ensure you have selected the correct team from the team switcher. 2. Open **Settings** in the sidebar. 3. In the **Spend Management** section, select the **Pause all production deployments** option. Then follow the steps to confirm the action. To learn more, see the [Spend Management documentation](/docs/spend-management#pausing-projects). ### Pause a project from the dashboard > **💡 Note:** To pause or resume a project from the dashboard, you need an [Owner](/docs/rbac/access-roles#owner-role) or [Member](/docs/rbac/access-roles#member-role) role, or the [Project Administrator](/docs/rbac/access-roles#project-administrators) role on that project. For more information, see [Access Roles](/docs/rbac/access-roles). To pause a single project manually: 1. On the Vercel [dashboard](https://vercel.com/d?to=%2Fdashboard\&title=Open+Dashboard), ensure you have selected the correct team from the team switcher and select the project you want to pause. 2. Open **Settings** in the sidebar. 3. On the **General** page, find the **Pause Project** section above **Delete Project** and select the **Pause Project** button. 4. In the dialog that appears, review the effects of pausing, type the project name to confirm, then select **Pause Project**. ### Pause a project using the REST API To pause a project manually or with a webhook you can use the [REST API](/docs/rest-api/projects/pause-a-project): 1. Ensure you have [access token](/docs/rest-api#creating-an-access-token) scoped to your team to authenticate the API. 2. Create a webhook that calls the pause project [endpoint](/docs/rest-api/projects/pause-a-project): - You'll need to pass a path parameter of the [Project ID](/docs/projects#project-id) and query string of [Team ID](/docs/accounts#find-your-team-id): ```bash filename="request" https://api.vercel.com/v1/projects//pause?teamId= ``` - Use your access token as the bearer token, to enable you to carry out actions through the API on behalf of your team. - Ensure that your `Content-Type` header is set to `application/json`. When you pause your project, any users accessing your production deployment will see a [503 DEPLOYMENT\_PAUSED error](/docs/errors/deployment_paused). ```bash filename="cURL" curl --request POST \ --url "https://api.vercel.com/v1/projects//pause?teamId=&slug=" \ --header "Authorization: Bearer $VERCEL_TOKEN" ``` > **💡 Note:** You can also manually make a POST request to the [pause project > endpoint](/docs/rest-api/projects/pause-a-project) without > using webhook. ### Resuming a project Resuming a project can either be done through the [REST API](/docs/rest-api/projects/unpause-a-project) or your project settings: 1. Go to your team's [dashboard](https://vercel.com/d?to=%2Fdashboard\&title=Open+Dashboard) and select your project. When you select it, you should notice it has a **paused** icon in the team switcher. 2. Open **Settings** in the sidebar. 3. On the **General** page, find the **Pause Project** section above **Delete Project** and select the **Resume Project** button. You can also select **Resume Project** in the banner at the top of the same page, or in the banner on the project overview page. Resuming takes effect immediately and does not ask for confirmation. Your production deployment will resume service within a few minutes. You do not need to redeploy it. ## Deleting a project Deleting your project will also delete the deployments, domains, environment variables, and settings within it. If you have any deployments that are assigned to a custom domain and do not want them to be removed, make sure to deploy and assign them to the custom domain under a different project first. To delete a project: 1. On the Vercel [dashboard](https://vercel.com/d?to=%2Fdashboard\&title=Open+Dashboard), ensure you have selected the correct team from the team switcher and select the project you want to delete. 2. Open **Settings** in the sidebar. 3. At the bottom of the **General** page, you’ll see the **Delete Project** section. Click the **Delete** button. ![Image](`/docs-assets/static/docs/concepts/projects/delete-project-light.png`) 4. In the **Delete Project** dialog, confirm that you'd like to delete the project by entering the project name and prompt. Then, click the **Continue** button. --- [View full sitemap](/docs/sitemap)