Skip to content

Latest commit

 

History

History
100 lines (57 loc) · 4.71 KB

github-sync.md

File metadata and controls

100 lines (57 loc) · 4.71 KB

/* Title: GitHub Sync Description: Learn how to sync Glo with GitHub Issues. Sort: 4 */

Syncing your GitHub Issues in Glo lets you break issues out into columns and visualize them in Glo.

What gets synced from GitHub?

  • GitHub Issues
  • Assignees
  • Description
  • Comments
  • Labels

Connect to GitHub

The Connect to GitHub button is available from the bottom of the left Boards panel in Glo.

You can also connect to GitHub from the Integrations section of the User Options menu.

Click the Connect to Github button, login to GitHub, and authorize Glo.

You GitHub account should now be connected to Glo!


Create a Synced Board

Open the Boards panel and click on the Create a synced board button.

Search for the GitHub repo issue board you wish to sync.

**Note:** You must be an administrator for the GitHub repo to create the initial synced board. The repo name will be grayed out with a lock icon if you don't have administrator permissions on that repo.

**Heads up!** Glo has a max syncing limit of 1000 issues. If you have repos with 1000+ issues you wish to sync, consider first archiving older issues in GitHub.

Click the Yes, create synced board button to confirm that you wish to sync this board with Glo.

GitHub synced boards will be indicated by the GitHub logo to the left of the board name.

**Important:** Glo's GitHub Sync relies on a repo webhook created during the sync set up. Please do not modify or remove this webhook as this will cause the GitHub sync to fail.


Managing Synced Boards

When you first sync a board, you will start out with just one column in Glo. However from here you can create more columns and build out the workflow for your issues.

From here, new issues added to GitHub will now sync to Glo.

Conversely, new cards added to Glo will also be synced to GitHub. You may need to refresh GitHub to see the new issue.

Type the GitHub issue number in the search field to quickly find corresponding card.

Also, if you ever want to jump to the GitHub issue from Glo, click on this icon to access the link: