Skip to main content

Managing Repositories

The plugin automatically discovers Bitbucket repositories from Git remotes configured in your project. If automatic discovery doesn't find your repository, or you want to manage which repositories are tracked, use the Manage Repositories dialog.

Automatic Discovery​

When you open the Bitbucket Pull Requests tool window, the plugin scans your project's Git remotes and matches them to Bitbucket repositories. Discovered repositories appear in the scope dropdown automatically.

Opening the Manage Repositories Dialog​

Click the Manage Repositories action in the toolbar (gear icon) of the Bitbucket Pull Requests tool window, or go to Settings | Bitbucket Integration Pro | Project | Manage Repositories.

Adding a Repository​

  1. Click + (Add) in the toolbar.
  2. Select the target instance from the popup:
    • For Bitbucket Cloud, select Bitbucket Cloud.
    • For Bitbucket Data Center, select your instance, or choose Other... to enter a server URL (e.g., https://bitbucket.example.com).
  3. Authenticate when prompted.
  4. Browse or search for the repository.
  5. Select the repository and click OK.

Configuring VCS Mappings​

Each repository in the table has two configurable columns:

  • VCS Root — the local Git root associated with this repository.
  • VCS Remote — the specific Git remote URL to use (e.g., origin).

The plugin tries to match these automatically, but you can adjust them via the dropdown editors in the table.

Repository Groups​

You can organize repositories into groups:

  • Project — repositories stored in project settings (default).
  • Named groups — IDE-wide groups that persist across projects. Use the group dropdown at the top of the dialog to create, rename, copy, or delete groups.

Other Actions​

  • Remove — select a repository and click - to remove it.
  • Reset — revert to the last saved state.
  • Discover from Scratch — clear all repositories and re-run automatic discovery.
note

Saving changes in the Manage Repositories dialog will close all open pull request tabs to apply the new configuration.