# Vercel

URL: https://docs.xodia.ai/integrations/vercel
Last updated: 2026-10-22

Connect Vercel once and every project Vercel builds from your GitHub repository shows its live address, domains and deploys in Xodia. When a build fails, the log is one click from your AI. Vercel keeps deploying your site as it does today.

_Picture: Publishing's Live site card for a site on Vercel: the live address risebakery.com, deployed from main two hours ago, and under Builds and checks a failed Vercel build on the spring-hours branch with its error and Fix with your agent, and a passed GitHub check._

## What you get

- The live address and domains, and when the live branch last deployed
- Every deploy of every branch, ready, building or failed, with a link to its log
- A failed build's last log lines, sent to your AI with Fix with your agent
- Your Vercel environment variables, copied into the preview in one step; secret values stay on Vercel
- Vercel Web Analytics in Insights, through the same connection

Host connections come with Starter, Pro and Agency. Starter and up Owners and admins can connect by default.

## Connect Vercel

1. Open Connections

   In Xodia, open Connections in the workspace sidebar.
2. Choose Connect on the Vercel row

   Under Hosting, choose Connect on the Vercel row. Vercel opens: pick the account or team your site is in and the projects Xodia may read, and approve.
3. Projects link on their own

   Projects that Vercel builds from your GitHub repositories link to their Xodia projects. Open a project's Settings, Publishing to see its live site and deploys.

## Connect with an access token

If Vercel's approve page doesn't open, or you'd rather not install an app, connect with a token instead.

1. Create a token in Vercel

   In Vercel, open Account settings, then Tokens, and create a token. Give it the team your site is in and an expiry you're comfortable with.
2. Paste it in Xodia

   In Connections, on the Vercel row, choose Use a token, paste it and choose Connect Vercel.
3. Pick the team

   If the token reaches several teams, Xodia asks which one your site is in. Choose it and choose Connect this team.

Everything works the same, except deploy updates arrive within a minute instead of right away. Xodia keeps the token encrypted and never shows it again. To stop access, delete the token in Vercel or choose Disconnect.

_Picture: The Connections page's Hosting group with Vercel's Use a token form open: a field for the Vercel access token, where to create one in Vercel account settings, Tokens, and Cancel and Connect Vercel._

## Good to know

- Read only: Xodia never deploys or changes anything on Vercel. Publishing merges into your live branch and Vercel builds it.
- Secret and sensitive variables stay on Vercel; add those to the preview yourself.
- A project that doesn't build from the site's GitHub repository won't link on its own.

## Troubleshooting

### No Vercel project builds this repository

Import the GitHub repository on Vercel first. Xodia links it the next time you open Publishing.

### Vercel says Reconnect needed

Access was removed on Vercel, or the token expired. Choose Reconnect, or paste a new token.

> **Note:** Everything that works the same on every host, from variables to disconnecting, is in [Connect your host](https://docs.xodia.ai/integrations/hosts).