Browser Extension
Install, navigate, and manage your projects directly within GitHub's interface using Zenhub's integrated tools.
Zenhub's browser extension adds project management features directly within GitHub's interface. Instead of switching between separate tools, you can manage issues, track progress, and collaborate with your team without ever leaving GitHub.
Installing the Zenhub browser extension
Zenhub's browser extension is available for Chrome and Firefox, supporting the latest 3 versions of each official browser build. Visit zenhub.com/extension to download, or search for "Zenhub for GitHub" in the Chrome Web Store or Firefox Add-ons marketplace. After installation, the Zenhub logo appears in your browser's add-ons bar — click it to visit your most recent workspace or go to Account Management.
When you first visit a GitHub repository after installation, Zenhub will prompt you to sign in with your GitHub credentials.
NOTE: Zenhub requires read and write access to your GitHub data to enable all features, but never reads or modifies your actual code. All data access is limited to issues, pull requests, and repository metadata.
You'll know the extension installed correctly when a Zenhub tab appears alongside Code, Issues, and Pull requests in any repository.
Accessing Zenhub within GitHub
Click the Zenhub tab in any repository to access your Work Tracker. You can also use the keyboard shortcut z + b to open the Work Tracker from anywhere within a repository.
TIP: Press z + s to see the full list of available keyboard shortcuts within GitHub.
When viewing an issue, you'll see new options for assigning story points, connecting to epics, setting dependencies, and linking pull requests. Pull request pages include Zenhub options to link PRs to issues during creation and assign them to a pipeline.
Extension vs web app
Use the browser extension when you work primarily within GitHub's interface and want project management integrated with code reviews and repository navigation. Use the web application at app.zenhub.com when you experience performance issues with large repositories, need dedicated project management views, or are on a browser without extension support.
Both interfaces provide identical functionality with real-time synchronization. Changes made in the extension appear immediately in the web app and vice versa.
Permissions and organizational access
Zenhub extension access mirrors your GitHub permissions. If you can view a repository in GitHub, you can see its issues in Zenhub. If you have write access, you can modify issue assignments, story points, and pipeline positions.
For organizations using GitHub's third-party access restrictions, ensure Zenhub is approved for your organization. Organization owners need to approve Zenhub as a third-party application through GitHub's organization settings. For detailed permission configuration and SAML requirements, see the GitHub Permissions article.
Troubleshooting common extension issues
If Zenhub features aren't appearing in GitHub, check that you're using Chrome or Firefox official builds (not developer versions). Force an update through your browser's extension management page and temporarily disable other extensions to identify conflicts — ad blockers and privacy extensions commonly interfere with Zenhub.
For stale data or sync issues, verify that your GitHub permissions haven't changed recently and clear your browser cache and cookies for both GitHub and Zenhub. If the extension is slow with large repositories, use filtering options or switch to the web application.
FAQ
Q: Does Zenhub support dark mode?
A: Zenhub follows your operating system or browser's appearance setting. Switch your OS or browser to dark mode and Zenhub updates automatically — no separate toggle is needed within the app.
Q: Can I use Zenhub without installing the browser extension?
A: Yes. You can access all Zenhub features through the web application at app.zenhub.com. The extension provides convenience for users who work primarily within GitHub's interface.
Q: Does the extension work with GitHub Enterprise?
A: Yes. Contact Zenhub support for specific configuration requirements for your Enterprise setup.
Q: What browsers are supported besides Chrome and Firefox?
A: Only Chrome and Firefox have native extensions. Other browsers can access Zenhub through the web application, which works on any modern browser including mobile devices.
Q: Why does Zenhub need write access to my GitHub repositories?
A: Write access enables Zenhub to update issue metadata like story points and pipeline assignments. Zenhub never modifies your code, only issue and pull request metadata.
Q: What happens if I uninstall the extension?
A: Your Zenhub data remains accessible through the web application. Issue story points, epic relationships, and other Zenhub metadata persist and can be accessed through any Zenhub interface.