Installation

The plugin is available from the Atlassian Marketplace. Just search and install the plugin from your Bitbucket's administration area or download and upload it manually.

Adding Categories

 Note that you need permission to administer a project in order to assign categories for it.

Adding Categories to Projects

Navigate to the project's "Settings" > "Project details".

You can add categories by adding them to the "Categories" field. Just start typing and select (return key or mouse click) one of the already existing project categories or create a new one by selecting the first line.

Don't forget to hit "Save".

Image Removed

Image 1: Adding a category to a project (click to enlarge)

Adding Categories to Repositories

Navigate to the repository's "Settings" > "Repository details".

You can add categories by adding them to the "Categories" field. Just start typing and select (return key or mouse click) one of the already existing project categories or create a new one by selecting the first line.

Don't forget to hit "Save".

Image Removed

Image 2: Adding a category to a repository (click to enlarge)

Removing Categories

 Note that you need permission to administer a project in order to remove categories from it.

Removing Categories from Projects

Navigate to the project's "Settings" > "Project details".

You can remove categories by removing them from the "Categories" field. Just click on the x next to the category that you want to remove.

Don't forget to hit "Save".

Image Removed

Image 3: Removing a category from a project (click to enlarge)

Removing Categories from Repositories

Navigate to the repository's "Settings" > "Repository details".

You can remove categories by removing them from the "Categories" field. Just click on the x next to the category that you want to remove.

Don't forget to hit "Save".

Image Removed

Image 4: Removing a category from a repository (click to enlarge)

Using Categories

Using Project Categories

When at least one project is assigned a category, a Category Selection Bar will appear on the left of the Projects Overview Page. By clicking one of the tabs, the projects on the right side will be filtered accordingly.

There is one tab for each category that is assigned to projects. Additionally there is always an "All Projects" tab which displays each project. If there are projects not assigned any categories, there will additionally be an "Uncategorized Projects" tab.

With the "Filter Projects" field you are able to search all projects of the selected tab (by name, key and description).

Image Removed

Image 5: Filtering projects by category and name, key, description (click to enlarge)

Using Repository Categories

When at least one repository (of the current projects repositories) is assigned a category, a Category Selection Bar will appear on the left of the Repository Overview Page of a project. By clicking one of the tabs, the repositories on the right side will be filtered accordingly.

There is one tab for each category that is assigned to repositories in the current project. Additionally there is always an "All Repositories" tab which displays each repository of the current project. If there are repositories not assigned any categories, there will additionally be an "Uncategorized Repositories" tab.

With the "Filter Repositories" field you are able to search all repositories of the selected tab (by name).

Image Removed

Image 6: Filtering repositories by category and name (click to enlarge)

Please refer to this guide for instructions on how to install the Categories for Bitbucket.