Link Features to Branch

Before you begin:


A Feature in Zepel can be linked to a Branch.

Once you have linked a Feature to a Branch, Zepel can:

  • Move the Feature from “Todo” to “In Progress” automatically when you add your first commit.

  • Move the Feature from “In Progress” to “Done” automatically when you the branch’s pull request is merged.

To do this, you need to first link a Feature to a Branch. Let’s see how you can link a Feature to a Branch step-by-step:

  • Open the Feature you want to link to a Branch

  • Below the name of the feature you should see this button:

Link feature to Git


  • If you use a Git client to create a new branch, copy the suggested branch name and create a branch with that name. Once the branch is published on your Git service, the branch will be linked to the feature


Suggested Branch Name


  • If you prefer using a terminal to create a new branch, copy and run the command shown. This will create a new branch and automatically switch to the new branch.


Command to create and link feature to branch


A feature will get linked to a branch only after the branch is published to either GitHub, GitLab, or Bitbucket.

Once you begin working, Zepel will show all the progress you’ve been making in the branch right inside your Feature. This will also be reflected on your Progress page.


Feature branch progress in Zepel


Branch names suggested by Zepel are in the following format: feature/feature-id-feature-name

Once your Feature is linked to a branch, you don’t have to do any additional steps. Zepel will automatically move the linked Feature from “Todo” to “In Progress” when you add your first commit. When you merge a pull request in the branch, Zepel will automatically move the linked Feature from “In Progress” to “Done”.

Note: You can link a Feature to multiple branches.


Further Reading:

  1. Link item to a branch
  2. Link item to commit
  3. Link item to a pull request
  4. Open pull requests from within Zepel