> This page location: Tools & Workflows > Integrations (3rd party) > Deploy > Vercel
> Full Neon documentation index: https://neon.com/docs/llms.txt
> IMPORTANT: If this page contains inaccurate or outdated information, report it: POST to https://neon.com/api/docs-feedback with {"feedback": "describe the issue", "path": "/docs/guides/vercel-overview"}

# Integrating Neon with Vercel

Choose the right connection path in seconds

## Overview

This page helps you quickly choose the best Neon–Vercel integration for your project. Whether you're starting fresh or have existing infrastructure, we'll guide you to the right solution.

**Tip: Quick decision guide** Choose the **Vercel-Managed Integration** if you're new to Neon and want unified billing through Vercel.
Choose the **Neon-Managed Integration** if you already have a Neon account or prefer to manage billing directly with Neon.

---

## Compare the options at a glance

| Feature / Attribute     | [Vercel-Managed Integration](https://neon.com/docs/guides/vercel-managed-integration)                 | [Neon-Managed Integration](https://neon.com/docs/guides/neon-managed-vercel-integration)                     | [Manual Connection](https://neon.com/docs/guides/vercel-manual) |
| :---------------------- | :---------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------- |
| **Ideal for**           | New users, teams wanting a single Vercel bill                                                         | Existing Neon users, direct Neon billing                                                                     | Integration not required or custom                              |
| **Neon account**        | Created automatically via Vercel                                                                      | Pre-existing Neon account                                                                                    | Pre-existing Neon account                                       |
| **Billing**             | Paid **through Vercel**                                                                               | Paid **through Neon**                                                                                        | Paid **through Neon**                                           |
| **Setup method**        | Vercel Marketplace → Native Integrations → "Neon Postgres"                                            | Vercel Marketplace → Connectable Accounts → "Neon"                                                           | Manual env-vars                                                 |
| **Preview Branching**   | ✅                                                                                                     | ✅                                                                                                            | ✖️                                                              |
| **Neon Auth support**   | ✅ Auto-provisioned on preview branches                                                                | ✅ Auto-provisioned on preview branches                                                                       | Manual setup required                                           |
| **Branch cleanup**      | Automatic (deployment-based)                                                                          | Automatic (Git-branch-based)                                                                                 | N/A                                                             |
| **Implementation type** | [Native Integration](https://vercel.com/docs/integrations/install-an-integration/product-integration) | [Connectable Account](https://vercel.com/docs/integrations/install-an-integration/add-a-connectable-account) | N/A                                                             |

**Note: Branch cleanup timing** Branch cleanup behavior differs between the two integrations. Vercel-Managed cleanup depends on Vercel's deployment retention policy, which can delay branch deletion by months. Neon-Managed cleanup is triggered by Git branch deletion. See [Managing Vercel preview branch cleanup](https://neon.com/docs/guides/vercel-branch-cleanup) for details, workarounds, and recommendations.

---

## Choose your integration path

**Important: Do you need custom CI/CD control?** **If you want to build preview branching into your own CI/CD pipelines (for example, via GitHub Actions)**, use a **[manual connection](https://neon.com/docs/guides/vercel-manual)** instead of the automated integrations below.

For automated integrations, follow this simple flow:

## Do you have an existing Neon account?

**Do you already have a Neon account or project you want to keep using?**

- **✅ Yes** → Use **[Neon-Managed Integration](https://neon.com/docs/guides/neon-managed-vercel-integration)**
- **❌ No** → Continue below

## Choose your billing preference

**Where would you like to manage billing for Neon?**

- **Through my Vercel account** → Use **[Vercel-Managed Integration](https://neon.com/docs/guides/vercel-managed-integration)**
- **Directly with Neon** → Use **[Neon-Managed Integration](https://neon.com/docs/guides/neon-managed-vercel-integration)**

---

## Integration options overview

- [Vercel-Managed Integration](https://neon.com/docs/guides/vercel-managed-integration): Create and manage Neon databases directly from your Vercel dashboard. Supports preview branches.
- [Neon-Managed Integration](https://neon.com/docs/guides/neon-managed-vercel-integration): Link an existing Neon project to Vercel and keep billing in Neon. Supports preview branches.
- [Manual Connection](https://neon.com/docs/guides/vercel-manual): Connect your Vercel project to a Neon database manually.

---

## Next steps

## Get Started Checklist

- [ ] Choose your integration type
    Select Vercel-Managed, Neon-Managed, or Manual based on the decision flow above
- [ ] Follow the setup guide
    Click through to your chosen integration's detailed documentation
- [ ] Configure preview branching
    Set up database branching for your development workflow
- [ ] Test your connection
    Verify your database connection works in both production and preview environments

---

## Related docs (Deploy)

- [Cloudflare](https://neon.com/docs/guides/cloudflare-pages)
- [Deno](https://neon.com/docs/guides/deno)
- [Heroku](https://neon.com/docs/guides/heroku)
- [Koyeb](https://neon.com/docs/guides/koyeb)
- [Netlify Functions](https://neon.com/docs/guides/netlify-functions)
- [Railway](https://neon.com/docs/guides/railway)
- [Render](https://neon.com/docs/guides/render)