Frequently Asked Questions

General Inquires

New around here? Start with the basics.

How can I add a ZenHub badge to my GitHub repo?

To let your repo's users know you are powered by ZenHub, add the following snippet to your repo's README.md file:

<a href="https://zenhub.com"><img src="https://dxssrr2j0sq4w.cloudfront.net/3.2.0/img/external/zenhub-badge.png" alt="ZenHub logo"></a>

How can I report a bug, get help, or give feedback?

We are more than happy to help! Contact an account representative by emailing support@zenhub.com, or visit our public portal to leave feedback. When reporting a bug, include steps to reproduce and screenshots to help us fix it as soon as possible.

What happens if I am on a computer without ZenHub installed?

You will always be able to access GitHub in its original form and your information will be saved safely. ZenHub features will not be displayed until you install the browser extension.

How do I know if I have the latest version?

Chrome and Firefox will automatically update your extension, but this is not instantaneous. To manually update in Firefox, visit about:addons in your browser, then click the gear icon. To manually update your extension in Chrome, go to chrome://extensions in your browser, check the box beside Developer Mode, then click Update.

If I use Chrome and Firefox, do I have to download ZenHub twice?

Yes, you'll need to add ZenHub to both browsers. Simply visit zenhub.com, click Add the extension, then sign in with your GitHub credentials.

How do I know that ZenHub is installed?

You'll see a blue and white Z added to the right of your address bar. By selecting this button you will be presented with three options:

  1. Visit the Dashboard to manage your organization
  2. Browse our help resources available to you
  3. Sign out

What browsers and versions does ZenHub support?

The ZenHub extension is available for Google Chrome and Mozilla Firefox. The ZenHub web app is also available for Safari and mobile. We support the latest three versions for these official browser builds.

What is ZenHub?

ZenHub is an agile project management and product roadmaps solution, natively integrated into GitHub. With ZenHub installed, your team stays lean and agile: you can plan sprints, create epics, and visualize your workflow without leaving GitHub. ZenHub is available either inside GitHub via our browser extension or as a full featured standalone web app.

ZenHub Features

Dive deeper into ZenHub's robust features.

How do I invite others to use ZenHub on my repo?

You can direct them to ZenHub.com to install ZenHub. Once installed, they will be able to view your boards, epics, reports, and take advantage of other ZenHub features — as long as they have access to your repo.

What happens if I am on a computer without ZenHub installed?

You will always be able to access GitHub in its original form and your information will be saved safely. ZenHub features will not be displayed until you install the browser extension.

How do I connect several repos into one Board?

ZenHub's Boards support multiple repositories, making organization-wide collaboration seamless. Connecting multiple repos in one Board is easy: first, navigate to any ZenHub Board. Click Repos, then click Add Repos +.

In the next screen, you can easily customize the new Board's structure. In the preview screen, drag and drop pipelines to determine how they will be merged. (You can always fine-tune these configurations later.) When you have finished organizing, click Merge. Note that once you merge repositories here, you can also create Multi-Repo Burndown Charts. Learn more here!

How do I submit a feature request?

Add your request to our public portal. Don't forget to vote on current initiatives to show support for others' requests!

Permissions & Privacy

We take security & privacy seriously.

How do ZenHub permissions work?

The ZenHub Board for given repositories can be viewed by anyone with Read/Pull access to that repository. Any GitHub user who can view and clone the repository will be able to view the Board.

ZenHub Board issue manipulation/reprioritization can be performed by anyone with Write and Admin access to the repository. Any GitHub user who can push to the repository will be able to edit a ZenHub Board for that repository.

What are the details of ZenHub's GitHub access permissions?

ZenHub is committed to keeping your code and information safe, including full AES 256-bit encryption. For more, please see our Terms of Service and Privacy Policy. If you have further questions, email us at support@zenhub.com.

How secure is my data in ZenHub?

We take security very seriously and commit to doing everything in our power to keep your data safe and private. We use industry-standard encryption and integrate with GitHub's own Open Authentication (OAUTH) system. At no point do we have access to your GitHub credentials, and at no point do we ever read any of your code, your branches, or the contents of your issues or Pull Requests. Please refer to our Terms of Service and Privacy Policy for more details.

Why can't I see my organization on the ZenHub Dashboard?

If the organization's owner turns on third-party application access restrictions without whitelisting or granting ZenHub access, grant ZenHub access by performing these steps:

1. Revoke your ZenHub token by going to github.com/settings/applications and clicking Revoke.

Revoke

2. Go to your ZenHub Dashboard, sign out, then back in again. You should see the following:

Authorize

3. If you are an admin, you should see Grant Access if not, you will see Request Access.; Click on whichever of the two options you see. If you clicked Grant Access there are no further actions needed to get access to ZenHub.

4. If you clicked Request Access you will see that access request is pending:

Request pending

5. Please ask the organization's owner to do to the organization's Settings page, click Third-party application access policy, head to ZenHub and click review, then grant access as displayed in the screenshots below.

Review request
Grant access

6. Once access is granted, the organization's admin should see the following:

Access granted

7. Finally head back to your ZenHub Dashboard and sign out, then in again, and you should see your organizations!

Pricing & Plans

Learn about plans, payments, and more.

How do I add an admin for my organization?

It's helpful to grant admin capability to several team members. On the Dashboard's Manage your plan section, locate the person you wish to add and click the three dots beside their name. You will see an option to make them an admin if you are already an admin.

Who can make a payment on the Dashboard?

Your organization's administrators can control ZenHub's payment Dashboard; the Dashboard has limited functionality for non-administrators.

Note: Whomever makes the initial payment becomes that organization's administrator.

How do trials activate? What if we need another one?

Fourteen-day trials activate when you visit your organization's private repositories while signed in to ZenHub. During that time, you can use ZenHub with unlimited team members. Please contact us if your organization would like an extended trial to further evaluate ZenHub and make sure it's the perfect fit.

What forms of payment do you accept?

Our payments are securely processed by Stripe. We accept major credit cards including Visa, Mastercard, and American Express.

Can I pay for a subset of team members?

Of course — ZenHub admins can easily control licenses via the Manage your plan section of the Dashboard. That said, ZenHub gets more useful the more team members you onboard.

How do I pay for ZenHub?

Access your private Payments Dashboard to manage your team's ZenHub licenses. Under Account details in the Dashboard you can view and edit billing information (including credit card details), cancel your subscription, and view billing history.

What currency are subscriptions charged in?

All of our plans are charged in USD.

How does your pricing work?

ZenHub's pricing is pay-as-you-go, processed securely by Stripe. Your plan can grow with your team and there are no contracts to sign. ZenHub's Dashboard is your team's payment hub, where you can add licenses, make payments, grant administrative permission, and more.

Do I have to pay for every member that is part of my GitHub organization?

No — Only the users you want to have access need a ZenHub license. Head to the ZenHub Dashboard to purchase and assign licenses to your team members.

Can I pay yearly for a discount?

Yes, you save 20% with annual payments! To pay for ZenHub on an annual basis, click Add Licenses on your Dashboard and select the yearly option.

Who needs to pay for ZenHub?

ZenHub is free to use on public, personal, and academic repositories. For teams using private repositories, ZenHub is just ten dollars US, per user, per month. Visit our pricing page to learn more about ZenHub pricing and plans.

ZenHub Enterprise

Use ZenHub with GitHub Enterprise.

Can my organization trial ZenHub Enterprise?

Yes. Your entire team can try ZenHub Enterprise free for 30 days. Our dedicated account managers will guide you through the process of implementing a ZenHub Enterprise plan, customized to your needs. Contact us at enterprise@zenhub.com to learn more!

How secure is ZenHub Enterprise?

We know you've chosen GitHub Enterprise to keep your data secure — ZenHub Enterprise installs on your servers, runs behind your firewall and is configurable to your security requirements. All data is stored on machines that you control.

How is ZenHub Enterprise different from ZenHub?

ZenHub Enterprise delivers the powerful GitHub workflow features available on ZenHub, securely hosted on your own servers. It is the only project management tool that works natively within GitHub Enterprise. Learn more!

Start your next project with ZenHub

Try for free