Vercel

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

::callout{icon="heroicons-outline:rocket-launch"} 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 ::

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
   • Team ID (optional): Add 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

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="material-symbols:warning" color="warning"} Removing Projects

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

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="material-symbols:shield" color="info"} Permissions

The Deployment module uses Directus native permissions to control access. See Deployment Security for details on configuring roles and access policies. ::

Documentation

Working with Deployments →

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