Transferring an Integration
Transferring an Integration
You can transfer your installation of a Native Integration from one Vercel team to another. The transfer moves the installation, the resources it owns, and any prepayment balances and thresholds. Vercel also notifies the integration provider so they can update their own records.
This page covers transfers you start from the integration's Manage page. If you only need to move a single resource (for example, one database) instead of the whole installation, see Transfer a resource to another team. To move a project that depends on an integration, see Transferring projects.
Before you start
Make sure each of the following is true. If any check fails, you see an error and the transfer does not proceed.
| Check | Where to fix it |
|---|---|
| You are an Owner or Member of the target team | Ask a team Owner to add you |
| Your role on the source team allows you to remove this integration | Ask a team Owner to update your role |
| The integration is a Native Integration, not a Connectable Account | Connectable accounts cannot use this flow |
| The integration supports transfer | Some integrations do not support transfer. Contact the integration provider |
| The target team does not already have this integration installed | Uninstall it on the target team first |
| No active project on the source team is connected to a resource owned by this integration | Disconnect each project from each resource before starting |
| The source team has no unpaid invoices for this integration | Pay or void any open invoices |
| No integration store on the source team has a name that conflicts with an existing resource on the target team | Rename the conflicting resource on the target team |
| For paid integrations, the target team has a payment method on file | Add a payment method in the target team's billing settings |
If the Transfer Integration section does not appear on the integration's Settings page, the integration does not support transfer.
If the Transfer Integration button is disabled, your role on the source team does not allow transferring this integration. Hover the button for the exact reason, then ask a team Owner to update your role.
If the button works but you see "Feature not enabled for your team" after confirming the transfer, the marketplace transfer feature is not enabled for your source team. Contact Vercel Support to request access.
What happens to your projects
Because the transfer requires you to disconnect every project from this integration's resources before starting, projects on the source team lose access to the integration as you disconnect them. Vercel removes the integration's environment variables from each disconnected project.
Existing production deployments keep running with whatever environment variables they were built with, but new deployments fail until you reconnect the projects to the integration on the target team.
After the transfer, reconnect each project to the integration on the target team to restore environment variables and resource access.
Transfer the integration
- From your Vercel dashboard, select the source team in the team switcher.
- Open Integrations in the sidebar.
- Next to the integration you want to transfer, select Manage.
- Open Settings in the side navigation and scroll to the Transfer Integration section.
- Select Transfer Integration.
- In the dialog, choose the target team and select Continue.
- If the dialog asks you to select a payment method, pick one on the target team and select Continue. Vercel uses this payment method for future charges on the transferred installation. Free or unbilled integrations skip this step.
- To confirm, type the integration slug shown in the dialog, then type
transfer my integration. Select Continue. - Wait for the transfer to complete. Vercel sends you back to the source team's Integrations list. Switch to the target team to see the moved installation.
What does not move
| Item | What happens |
|---|---|
| Source-team project connections | The transfer is blocked while any project is still connected to a resource owned by this integration. After you disconnect every project and the transfer completes, no project connections remain. Reconnect your projects on the target team to continue using the resources |
| Source-team payment method | Stays on the source team. Vercel does not copy it to the target team |
| OpenTelemetry endpoints the integration provisioned | Vercel deletes them. The integration provider can recreate them on the target team |
| Historical usage data | Stays with the source team for billing reconciliation |
| Existing administrators on the integration | Reset to a single owner on the target team |