Velo: Fixing a Broken GitHub Integration

Git Integration relies on the Velo GitHub App to maintain the connection between your site and its GitHub repository. If the app is uninstalled or suspended, your site's GitHub integration stops working. This can also happen if you make changes to the repo's settings or to your GitHub account settings. When the connection between your site and GitHub is lost, a modal indicating the problem appears in the Editor.

The following sections explain each of the modals you might see in the Editor, and the steps you can take to fix your GitHub integration.

Repository Not Found

The GitHub repository cannot be found modal indicates that the Velo GitHub App can't find your site's repo. This happens in the following cases:

1. You deleted the repo.
2. You changed the repo's name.
3. You transferred the repo to another GitHub account or organization.
4. You changed your GitHub username.
5. You revoked the Velo App's access to the repo.

In the first 2 cases, you need to disconnect your site from GitHub. You can do this by clicking the Disconnect From GitHub button in the modal. Once you've done this, connect your site to GitHub again and create a new repo for your site. Please note that you can't reconnect your site to the original repo.

In the last case, you can restore the connection to your site's repo by granting the Velo App access to it:

1. Open GitHub in a new tab in your browser.

2. In the upper-right corner, click your profile photo and select Settings.

   

3. On the left sidebar, under Integrations, click Applications.

   

4. With the Installed GitHub Apps tab selected, find the Velo App and click Configure.

   

5. In the Repository access section, click Select repositories. Select your site's repository from the dropdown list. Click Save.

   

6. Refresh the Wix Editor.

Velo App Uninstalled

The Velo App on GitHub was uninstalled modal indicates that you have uninstalled the Velo App from your GitHub account. To reinstall the app, take the following steps:

1. Open the Velo App page in a new tab in your browser.

2. Click Configure.

   

3. Select where you want to install the app.

   

4. Select Only select repositories and select your site's repository from the dropdown list.

   

5. Click Install.

6. Refresh the Wix Editor.

Velo App Suspended

The Velo App on GitHub was suspended modal indicates that you have suspended the Velo App's access to your GitHub account. To unsuspend the app, take the following steps:

1. Open GitHub in a new tab in your browser.

2. In the upper-right corner, click your profile photo and select Settings.

   

3. On the left sidebar, under Integrations, click Applications.

   

4. With the Installed GitHub Apps tab selected, find the Velo App and click Configure.

   

5. In the Danger Zone section, click Unsuspend.

   

6. Refresh the Wix Editor.