GitHub

Worklenz connects to GitHub so your code activity shows up next to your tasks. An Owner or Admin connects the workspace once. After that, repositories are linked per software project.

At a glance


What it is	A workspace-level GitHub connection
Where to find it	Settings > System & Integrations > Integrations
Who can connect	Owners and Admins. Others see “View only” and “Only team owners and admins can connect GitHub.”
Plan	No plan restriction is shown in the app

How do I connect GitHub?

Open Settings > Integrations.
On the GitHub card, click Connect GitHub.
Approve the installation on GitHub.

Once connected the card shows Connected and how many repositories are available. If your GitHub organization needs approval, you see “Installation was requested. An organization owner needs to approve it.”

How do I refresh or disconnect?

Click Refresh repositories after you add repositories on GitHub. Sync status shows the current state, and a Suspended state is shown if GitHub suspends access.
Click Disconnect to stop. Syncing pauses, and existing links and history are kept and resume if you reconnect.

How do I link a repository to a project?

Linking is per software project, in the project’s settings under Integrations. Put the issue key in a branch, commit or pull request title to tie activity to that issue. Status automation can run on branch created, pull request opened and pull request merged. See GitHub for software projects.

Other integrations

Microsoft Teams, Google Drive and Google Calendar still show Coming Soon. Slack is available on Business.

Best practices

Connect with an Owner or Admin account, because only they can start the connection.
Refresh repositories after creating new ones, since the list does not update on its own.
Disconnect rather than delete, as links and history resume if you reconnect.