Troubleshoot project collaboration
This guide will help you understand how to troubleshoot deployment failures related to project collaboration.
For private repositories, if we cannot identify the Vercel user associated with a commit, any deployment associated with that commit will fail. You can use the following checklist to make sure your Vercel team is properly configured:
Ensure all contributors pushing code are members of your Vercel team.
For each team member, verify their Vercel account is connected to their git provider.
Confirm bot commits are properly configured by the git provider.
The Hobby Plan does not support collaboration for private repositories. If you need collaboration, upgrade to the Pro Plan.
To deploy commits under a Hobby team, the commit author must be the owner of the Hobby team containing the Vercel project connected to the Git repository. This is verified by comparing the Login Connections Hobby team's owner with the commit author.
To make sure we can verify your commits:
- Make sure all commits are authored by the git user associated with your account.
- Link your git provider to your Vercel account in Account Settings
If your account is not connected to your git provider, make sure you've properly configured your Vercel email address so that it matches the email associated with the commit.
For the most reliable experience, ensure both your project and account are properly connected to your git provider.
For more information, see Using Hobby teams
The Pro Plan allows for collaboration through team membership. Each person committing to your codebase should be added as a team member.
To deploy commits under a Vercel Pro team, the commit author must be a member of the team containing the Vercel project connected to the Git repository.
To make sure we can verify commits associated with your team:
- Each person committing code can be added as a team member.
- Make sure the commit author is a confirmed member of your team.
- Team members should link their git provider to their Vercel account in Account Settings
For more information, see Using Pro teams
Ensure your bots are properly configured and that their commits are clearly identified as automated.
Each team member must connect their git provider account to their Vercel account:
- Visit Account Settings
- Navigate to the Login Connections section
- Connect your GitHub, GitLab, or Bitbucket account
If you use multiple email addresses for git commits, you will need to configure a secondary email address with either your git provider or Vercel depending on if your git repository is linked to your project.
To add secondary email addresses to your Vercel account:
- Go to your Account Settings
- Add any email addresses you use for git commits
- Verify each email address
Was this helpful?