Non-disruptive network maintenance Saturday

By on January 24, 2014

On Saturday, at approximately 8:30PM GMT, Bitbucket will perform non-disruptive network maintenance.

We will be performing physical cabling work in our patch racks in preparation of expanding our network capacity.  We don’t anticipate that this will have any affect on site performance or availability.

Important Changes Are Coming to Teams

By on January 14, 2014

Starting February 18, 2014, Bitbucket will remove the ability for individuals to log into a team with a username/email and password. We are taking this action so that we can bring you Atlassian ID later this year. Atlassian ID is single sign-on across all our OnDemand services such as Bitbucket, JIRA, HipChat and Confluence, one of the most popular feature requests on Bitbucket!

What does this mean to you

Other housekeeping

As part of this change, any team that has no groups or individual members has been converted to an individual account. This is a very small subset of users who will notice absolutely no change in their daily work.

Help I’ve lost my way

Don’t worry! We’ve put together a complete guide in the Bitbucket Knowledge Base to help you out. If you’re still lost, the Bitbucket’s support team is here to help you troubleshoot any problems or questions you may have with this migration. Simply file a support ticket and you’ll be good to go.

SourceTree for Mac 1.8 – Subtree Support & Mavericks Improvements

By on December 11, 2013

We’re happy to announce the release of SourceTree 1.8. This release includes the much anticipated Subtree support and important Mavericks updates to improve stability.

Download SourceTree


Submodules were a feature of Git that many people had trouble working with and so subtrees were introduced as a way to solve many of the problems submodules introduced. We’re happy to announce that you can do all of this right from within SourceTree with a little zest added to make subtrees even easier to manage.

Easily add subtree's with SourceTree

SourceTree stores subtree metadata so you can simply pull commits from your remote into your subtree without having to provide the same information over and over. Take a look at Atlassian’s blog “Alternatives To Git Submodule: Git Subtree” to find out more information about how to use Subtree with Git.

Mavericks Updates and Fixes

With a big thanks to the community we’ve been able to track down any outstanding compatibility issues with Mavericks. Version 1.8 of SourceTree includes a fix for the ‘error on commit’ issue, as well as startup crashes that a small number of users were experiencing.


We want to make SourceTree an even better product for you, our users, and to do this we’d love your help in finding out how you use our product. In version 1.8 you’ll get a popup asking if it’s OK to gather some data about how you use the product. We want to emphasize that no personal data is taken whatsoever.

Other fixes / updates

Download SourceTree

Get SourceTree for Windows

Don’t forget, SourceTree is also on Windows too. Grab the latest version from!

API 2.0: New function and enhanced usability

By on November 12, 2013

Today, Bitbucket officially launches our 2.0 REST APIs. This release supplies new functionality you can use to automate teams, repositories, branch restrictions, and manage pull requests. In this release you’ll get the ability to:

We are especially proud of the 2.0 API’s usability. Our API offering has grown over the years while we raced to deliver you a feature-rich APIThe 2.0 API is optimized for RESTfulness, discoverability, consistency, performance, and flexibility.

Discoverable resources through links

Every 2.0 endpoint contains a links element that points to related resources. Links give a caller the ability to quickly discover and traverse related objects. We think you’ll find an object’s links perform a  “self-documenting” function for every endpoint.

$ curl
  "username": "evzijst",
  "website": "",
  "display_name": "Erik van Zijst",
  "type": "user",
  "links": {
    "self": {
      "href": ""
    "repositories": {
      "href": ""
    "html": {
      "href": ""
    "followers": {
      "href": ""
    "avatar": {
      "href": ""
    "following": {
      "href": ""
  "created_on": "2010-12-02T18:32:03+00:00",
  "location": ""

Links can be actual REST API resources, or they can be informative. In this example, informative resources include the user’s avatar, and the HTML URL for the user’s Bitbucket account.

Paginated responses

Many endpoints return collections of objects. To avoid overwhelming clients with excessively large responses, the 2.0 API breaks these returns into manageable pages wrapped in a well-defined structure:

  "next": "",
  "values": [],
  "pagelen": 10,
  "size": 265,
  "page": 2,
  "previous": ""

The next and previous links ensure you don’t have to hard code or manually construct any links. Paginated responses always contain a values list and next link (except for the last page of course). All other elements are optional, depending on the underlying data set (backwards navigation is not always supported).

Standardized error responses

For when things don’t work out so well, we’ve standardized the error response layout. The 2.0 API serves a new JSON object along with the appropriate HTTP status code. The JSON object provides a detailed problem description:

"error": {
  "message": "Bad request",
  "fields": {
       "src": [
           "This field is required."
  "detail": "You must specify a valid source branch when creating a pull request.",
  "id": "4545180c2f36d7cdbea3c6c3c22c52e1c3a40fd9"


Standard ISO-8601 timestamps

Oh, and while we were at it, we made it so the 2.0 API uses standardized ISO-8601 timestamps. This standardization should eliminate the need for custom date parsing patterns.

Interactive REST browser


For details of the specific APIs, visit our documentation or try an API interactively in the REST browser.

SourceTree update includes new Bitbucket integrations

By on November 5, 2013

Last week we announced improvements to make branching easy for everyone on your team, from from the novice, to the most experienced developer. The most recent update to SourceTree for Windows and Mac takes branches one step further: It adds new integrations that make checking out your branches and submitting pull requests back to your team easier than ever.

Cloning improvements

Did you know that you can clone your repositories into Bitbucket without having to use the command line? Click the Check out in SourceTree clone option in Bitbucket and Stash, and your clone details will automatically be configured in SourceTree for you to instantly download source.

Check out in SourceTree

With the new versions of SourceTree, when using the Bitbucket Check out in SourceTree button after creating a new branch, some extra help is given: If you’ve already got a checked-out copy of the repository you’re attempting to clone, SourceTree will show you the existing, and switch the working copy to your newly created branch.

Create pull requests via SourceTree

If your team is like ours, you’ll want to submit a pull request on Bitbucket after finishing up your commits on your local branch – a task that involves pushing your code, navigating to your repository, creating a pull request, selecting the branches, picking your reviewers, and submitting. That’s a lot of clicks.

Create PR from SourceTree

But with this latest update, you can cut out several steps from your daily dev cycle by creating pull requests straight from SourceTree. Just click on the menu item (Repository > Create pull request) and away you go.

Get SourceTree for free!

If you’re new to Git or Mercurial, or just want a handy tool to make you even faster, download SourceTree for Windows or Mac – it’s free!

Download SourceTree Free

Branch based workflows simplified

By on October 30, 2013

Bitbucket has just made one of the key strengths of Git – branching – accessible to all users, new or experienced. From the repository header, you can now quickly create a branch and take advantage of feature-based workflows that Git opens up.

New Repository Header

In a single click, Bitbucket will create a new branch for you with the option to choose where you want to branch from.

Create branch dialog

Bitbucket even lets you check out your branch in SourceTree, Atlassian’s free Git client for Mac and Windows, so you can start working on your code faster without having to use the command line.

Branches at a glance

Visualizing branches has never been easier. Quickly identify outstanding work that needs to be merged, or check how up to date your working branch is from the default branch (e.g. master) with the Behind/Ahead function

Branch details

You can do common tasks such as deleting branches, creating pull requests, or clean up any stale or short-lived branches that may be clogging up your repository with the Delete branch feature. If you’re looking for more details, you can even drill into your branches and commits with branch information available on the branch details view. Organizing branches has never been easier!

Check out Bitbucket for free

Bitbucket is free for individuals and teams of five or less, and includes unlimited repositories. Start a free trial today and get up and running in a matter of minutes!

Create a free account

Updated Status Site

By on October 11, 2013

Status Site

We are happy to announce that we’ve updated our site to contain a whole heap of improvements.


We understand that when Bitbucket is unavailable that you, our users, can’t get your work done. We take this responsibility very seriously.

To meet our availability goals we monitor all aspects of the Bitbucket service. Our new status site provides deeper insight into this status.

We now provide automated updates to the availability of:

One of our values here at Atlassian is Open Company, No Bullshit. To that end we are now publishing some important statistics related to how well Bitbucket is servicing you. The status site now shows:

Leveraging the community to make it all go

Our new status site is powered by the amazing folks over at These guys have an awesome product that integrates with all of our existing monitoring tools such as NewRelic and Pingdom.

We were able to get our initial site setup in under 2 hours. They also allow a great level of customization that allowed our designer to make the site look and feel just like home.

Revamped Bitbucket Integration with HipChat Group Chat

By on October 10, 2013

Atlassian HipChat, group chat and IM for teams, recently improved the integration experience with Bitbucket. What does this integration do? It connects a HipChat room to one or more Bitbucket repositories. From there you and your team can stay notified of code activity in real-time via HipChat.


Connect your code and chat

The previous Bitbucket integration involved two tabs, multiple copy-paste steps, and lots of clicking. The goal was to make the integration as simple as possible to connect our chat service with our code hosting service.


With the new HipChat-Bitbucket add-on, all it takes is the following steps to get connected:

  1. Visit HipChat and login
  2. Click on “Rooms” tab
  3. Click on desired room
  4. Click on “Add-ons”
  5. Find Bitbucket addon, and click “Install”
  6. Type the repository name, and click “Add”

No more copy/paste of obscure links, tokens, or IDs.  No documentation to read.


This plugin is installable by any room owner and does not need any account admin privileges, so if you own a HipChat room, you can set it up yourself.

Code and chat for FREE

Try the integration out. HipChat and Bitbucket are both free for 5 users.


Become a leader on the Bitbucket team

By on October 8, 2013

Bitbucket team

Bitbucket is growing in leaps and bounds; we passed our one million user mark back in June! Expanding the service means expanding the team, so we’re hiring for a number of SF-based leadership positions:

About Atlassian

Bitbucket is a part of Atlassian, one of the “Best Small & Medium Companies to Work for in America.” Our products reach over 25,000 enterprise customers globally, including Pixar, Twitter, Netflix, NASA, and Facebook.

With offices in Sydney, San Francisco, and Amsterdam, we’re growing fast, and we’re building a different kind of software company: one that listens to customers, values innovation, and solves customer problems with brilliant simplicity. You’ll have a direct impact on millions of users as soon as you start! Find out more about life at Atlassian.

Sound good?

Show us your résumé, CV, blog, Bitbucket or GitHub profile, open-source contributions, or stuff you’ve built. To find out more, drop us a line at llocke at atlassian dot com. We want to see your amazing work!

Take control with branch restrictions

By on September 16, 2013

With Git, branching has never been easier — especially with the introduction of amazing new workflow capabilities such as git-flow. Some development workflows require that specific developers oversee merges into the master or release branches, while other developers work on bug-fix and feature branches.

Bitbucket’s latest feature, branch restrictions, lets you turn this “gentlemen’s agreement” into a seamless, enforceable process, reducing confusion and time wasted backing out changes that were merged prematurely.

Enforce your workflows

At the heart of branch restrictions is a new repository write permission that allows you to control who can commit to specific branches in a repository. Branch permissions are set on a per-repository basis by specifying a user or group who already has access to a given repository.

Bitbucket Branch restrictions

Restrictions are based on explicit branch names, or you can use advanced branch permissions to match multiple branches (or tags) using pattern matching. For example, use an * (asterisk) in a rule: “f*r” matches foobar and footer. Establishing naming conventions based on roles or functional area (e.g., “contractor_” or “userauth_”) makes it even easier to set and standardize permissions throughout your organization.

Edit-undo becomes a thing of the past

Simplify your Git repository management

Bitbucket is free individuals and teams of five or less, and includes unlimited repositories. Start a free trial today and get up and running in a matter of minutes!

Create a free account