# Vercel

> Connect Directus with Vercel to trigger deployments, monitor build status, and manage your frontend projects directly from your Directus instance.

Connect your Directus instance with Vercel to centrally manage deployments, monitor build status, and control multiple frontend projects — all without leaving Directus.

<callout icon="i-lucide-rocket">

**Quick Start**

1. **Enable Deployment module**: Enable the Deployment module from your Directus project settings
2. **Connect your Vercel account**: Navigate to the Deployment module and add your Vercel API token
3. **Add projects**: Connect one or more Vercel projects to your Directus instance
4. **Start deploying**: Trigger builds and monitor deployment status from Directus

</callout>

<partial content="deployment-public-instance">



</partial>

## Getting Started

### Connect Your Vercel Account

1. In Directus, navigate to **Settings**
2. From the **Modules** section, enable the **Deployment** module
3. Navigate to the Deployment module now shown in the **primary navigation**
4. Select **Configure Vercel** to begin the integration

  - **Personal Access Token**: Your Vercel API [access token](https://vercel.com/kb/guide/how-do-i-use-a-vercel-api-access-token)
  - **Team ID (optional)**: Add your [Team ID](https://vercel.com/docs/accounts#find-your-team-id) if you want to deploy team projects rather than personal projects
5. Click **Save** to establish the connection and begin adding projects

![Vercel configuration token](/img/vercel-configuration-1.png)

### Configure Projects

1. From the **Vercel Configuration** screen, select **which Vercel projects** you want to manage from Directus
2. Click **Save** to add the projects to the integration
3. You can return to the Vercel integration settings at any time to add or remove projects

<callout icon="i-lucide-triangle-alert" color="warning">

**Removing Projects**<br />


Removing a project from the Vercel integration will also permanently delete all deployment history for that project from Directus. This action cannot be undone.

</callout>

![Vercel configuration projects](/img/vercel-configuration-2.png)

### View Your Projects

Once configured, your connected Vercel projects will be listed in the Deployment module. From here you can:

- View all connected projects at a glance
- Access deployment controls for each project
- Monitor deployment status and history

<callout icon="i-lucide-shield" color="info">

**Permissions**<br />


The Deployment module uses Directus native permissions to control access. See [Deployment Security](/guides/deployments/security) for details on configuring roles and access policies.

</callout>

![Vercel configuration projects](/img/vercel-configuration-3.png)

## Documentation

**Working with Deployments →**

Trigger deployments, monitor build status, and manage your frontend projects directly from your Directus instance.