ZenHub unites your team within the GitHub interface with our extensions for Chrome and Firefox, while also integrating team members who need to track, manage, and report on projects but are looking to stay focused and may not be too familiar with the GitHub UI through app.zenhub.com.
Using ZenHub Enterprise?
Send us an email with what team you're part of and we'll get you set up with the right URL for your team to access ZenHub on web and mobile.
Signing in and selecting a workspace
Once signed in, you'll be prompted to select which GitHub Organization you'd like to get started with. If you're only using GitHub with a personal repository, select your own username in the list of organizations.
Can't find your organization listed in the web app? This may be because your GitHub organization hasn't yet granted ZenHub permissions. You can grant third-party access for ZenHub by following the steps outlined here.
Once you've selected the organization you'd like to start in, select the repository or Workspace within that organization you'd like to kick-off with. Unsure what repositories are and how they are used in ZenHub? Learn more about repositories, ZenHub, and important agile concepts in our terminology guide here.
If you're just getting started, best practice is to select the repository where you're taking majority of your work.
Using ZenHub, you can connect repositories together – even across GitHub organizations – to get a bird's eye view into everything going on across all your team's workspaces. With advanced filters, you can drill down to see only what you need. Learn more here.
Don't yet have any repositories created? Head to github.com and click on the + icon that appears on the top-right corner of any page, then click New Repository.
Once you've selected the repository, you're ready to kick things off in the Board! Learn more best practices about ZenHub Boards here.
Favoriting a Workspace
If you frequent the same few Workspaces to manage your work, you can favorite a Workspace to have it at the top of the Workspace navigator. Click the star next to the Workspace name on the sidebar to add it to your favorites:
Once favorited, it'll be added to the sidebar navigation for easy access:
Navigating the sidebar
Once you're in the product, the sidebar in ZenHub is activated by clicking on the Workspace switcher next to your Workspace name. This will open a list of favorited and recent repositories you've visited within the organization. If you're looking for a repository that isn't listed in this screen, you can use the search bar to quickly bring up that Workspace/repo:
If you belong to more than 1 organization, or need to access a personal repository you can click on the name of the current organization you're in, or ∨ arrow at the top of the Workspace navigator to toggle between organizations:
For every repository, or multi-repo Board in ZenHub, the notifications tab will populate with what you've missed based on the space you're viewing and your personal notification settings.
Notifications are managed on a per-Board basis. If you have a multi-repo Board connected, the notifications for all repositories connected within that workspace will be accessible through the notification tab when viewing any of the connected repositories.
To change your notification settings, head to Manage notifications on the bottom-left of the sidebar then click on the top-right drop-down to make a change.