Skip to main content

GitHub: link PRs and branches to tasks

Connect a GitHub repository to link branches and pull requests to Examply tasks and auto-update task status.

The GitHub integration links your code to your tasks. Connect a repository once, then reference a task from a branch name or pull request to keep engineering work and project tracking in sync.

This matters most for product teams that plan work in Examply but ship it through GitHub: instead of updating a task by hand every time a pull request opens, merges, or gets reviewed, the link keeps itself current and gives anyone checking the task a direct path to the code.

Note: The GitHub integration requires a Starter plan or higher and admin access to the repository you're connecting.

Connecting a repository

  1. Go to Workspace settings → Integrations → GitHub and click Connect.

  2. Authorize the Examply GitHub App for your organization.

  3. Select which repositories Examply can access.

  4. In each project, go to Project settings → Integrations and choose the repository to link.

Linking with branch names

Include a task's ID in a branch name and Examply links it automatically. Task IDs appear in the task's URL and at the top of the task panel.

git checkout -b EX-1042-fix-timesheet-rounding
git push -u origin EX-1042-fix-timesheet-rounding

Once the branch is pushed, the linked task shows the branch name and its latest commit. Opening a pull request from that branch links the pull request as well.

Updating task status automatically

Add a keyword to a pull request description to move the linked task's status when the pull request merges:

Keyword

Effect on merge

Closes EX-1042

Marks the task complete

Fixes EX-1042

Marks the task complete

Refs EX-1042

Links the task without changing its status

You can reference more than one task in a single pull request by listing multiple keywords on separate lines. Merging a draft pull request doesn't trigger these keywords until the pull request is marked ready for review and then merged.

Reviewing linked activity from a task

Open any linked task and check the Development panel to see every branch, commit, and pull request associated with it, along with each pull request's current status: open, in review, or merged. This gives a project manager visibility into engineering progress without needing GitHub access.


Troubleshooting

If a branch or pull request doesn't link, check that the task ID matches exactly, including the project prefix, such as EX-. Renaming a branch after pushing doesn't retroactively create a link, so open a new branch instead. For access issues, confirm the repository is still selected in Workspace settings → Integrations → GitHub.

Did this answer your question?