Help Center

Merge multiple GitHub repositories to make multi-repo Workspaces

Software projects often span across several GitHub repositories, so naturally, your Workspace tracker and reports should too.


Using ZenHub, you can connect repositories together—even across GitHub organizations—to get a bird's eye view into everything going on with your software projects. 


Creating multi-repo Workspaces

To merge multiple repositories together, get started using the Repos dropdown on the top left of any ZenHub Board.


To merge repositories together, you need to have write permissions to all repositories in GitHub you'd like to merge.


Using the Add a repo + option, search for the repository that you'd like to connect. Using the avatar on the bottom left of the modal, you can toggle across all Organizations and personal repositories that you have access to. If the repository you'd like to add is in another one of your GitHub organizations, you can connect this using the custom link on the bottom left, where the avatar for your organization is located. After confirming the repository you'd like to connect to your Workspace, define your ideal workflow. You'll be presented with a preview screenwhere you'll need to decide where to place the Issues in the Workspace.


You can either:

1. Group all Issues together (default)

2. Copy pipeline groupings from an existing Workspace


When you have finished organizing your pipeline stages, click Complete Board Setup to finish.



Important! Before merging Boards together, have a discussion with your team.


 While you can disconnect a repository from the central multi-repo Workspace at any time, the prioritization of all Issues inside the Board will be lost once disconnected. Make sure your team is onboard with the merge beforehand.


Learn more about Issue placement in Workspaces here.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.