Meet the Bitbucket interface
Before you begin, sign up for a Bitbucket Cloud account so you can roll up your sleeves and try things for yourself. This guide will give you a quick tour of the parts of Bitbucket you’ll use a lot, so keep this tab open while you sign up. We’ll be here when you’re done.
Want to get started with Bitbucket Server? Go here.
Now let’s introduce you to the Bitbucket user interface and what you need to get started.
Your work
The Your work dashboard displays the pull requests and repositories you care about.
- On the Your work dashboard you’ll see open pull requests that have you as a reviewer, open pull requests you’ve created, and a list of repositories you can access.
- Using the filter in the upper-right corner, you can tweak these lists to suit your needs. For example, you might want to hide pull requests with broken builds, so you only see code that’s ready to merge.
Repositories
The Repositories view lists all the repositories you can access.
- By default its organized by the Last updated repository, so you’ll see the most recently changed repository at the top. Or you can search for a repository by name, or filter the list by Project or repository Owner.
- You can also only display the repositories you are watching by selecting the Watching filter.
Projects
Projects allow you to group and organize your repositories to make them easier to find. In the Projects view you’ll see existing projects and can create a new projects. Clicking on a project displays all the repositories in that project.
Pull requests
Code review is crucial step in the software development life cycle and helps ensure you’re shipping quality with confidence. Pull requests are where code review happens in Bitbucket, and the Pull requests view helps you quickly find what needs your attention.
Use the quick filter buttons to change which pull requests are listed:
- Reviewing - Pull requests you’re reviewing
- Watching - Pull requests you’re watching
- Mine - Pull requests you created
- Teams - Pull requests your team created
Issues
When you add a repository to Bitbucket Cloud, you also get an issue tracker. This is the place to track your project's feature requests, bug reports, and other tasks.
Your Bitbucket settings
Bitbucket settings is where you’ll find important settings for managing your account, like:
- Security settings - SSH keys and two-step verification
- Notifications settings
- Apps and integration - find, install, and manage apps from the Bitbucket marketplace
To get to your Bitbucket settings, click your avatar in the lower-left corner and select Bitbucket settings.