Skip to main content

Managing Repositories

The plugin matches your project's Git remotes to Bitbucket repositories and adds what it finds to the scope dropdown. Use the Manage Repositories dialog when discovery misses a repository, or to control which repositories are tracked.

Opening the Manage Repositories Dialog​

Click the Manage Repositories in the Choose Scope popup in the Bitbucket Pull Requests tool window, or go to Settings | Bitbucket Integration Pro | Project | Manage Repositories.

Adding a Repository​

  1. In the Manage Repositories dialog, click the + (Add) button 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​

A VCS mapping associates a remote repository with a local Git root. Features such as Jump to Source and branch checkout need one, and where a mapping exists the plugin reads data such as file diffs from local Git instead of the server, which is faster.

The plugin fills the VCS Root and VCS Remote columns automatically. Adjust them in the table when a repository is matched to the wrong root or remote.

Repository Groups​

Repositories belong either to the Project group, stored in project settings, or to a named group that is IDE-wide and persists across projects. Use the group dropdown at the top of the dialog to create, rename, copy, or delete named groups.

Other Actions​

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

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