New direct image uploads for Bitbucket

By on February 12, 2014

A picture is worth a thousand words, and this is one cliché that the Bitbucket team takes to heart. Every day, we use images to help make things clearer a screen shot of a feature gets added to your code review so reviewers know what to expect, or an illustration of steps involved to reproduce a bug when creating a JIRA issue. Images can liven up the documentation on a wiki, or just help make a point.

Our guess is, your team does this too. So we’re happy to announce that today, we’re making it really easy to do all these fun and useful things by uploading your images right to Bitbucket.

Image uploader

Say it with .JPEGs (or .PNGs, or .GIFs)

You can upload images anywhere you see the markup toolbar – just click the image button to get started. Select an image from the file chooser or drag one to the dialog, or you can drag an image right into the comment box! We’ll upload your image and insert the link into your markup, ready to be seen.

Image drag and drop

Image privacy

Uploaded images use the same security settings as the repository they are added to. If your repository is private, only people with access can see the images you upload there.

Scheduled Maintenance Saturday, February 8, 2014 at 18:00:00 UTC

By on February 6, 2014

We’re planning scheduled maintenance Saturday, February 8, 2014 at 18:00:00 UTC lasting no more than two hours. During this maintenance window we will restart our master PostgreSQL database and Redis data structure server to apply system updates.

Thank you for your patience as we work to improve Bitbucket’s reliability.

SourceTree for Windows 1.4 released!

By on January 29, 2014

To celebrate the new year (admittedly a little belatedly), how about a new major version of SourceTree for Windows? We have a doozy for you to start off 2014.


git-svn support


You can now use SourceTree for Windows to interoperate with your old Subversion projects via git-svn. This works by letting you work with a Git repository locally, but you can interact with a remote SVN repository via clone, push, and pull, thereby combining the benefits of a fast and flexible local DVCS, while still collaborating effectively with your projects that are still running legacy repositories.

Command line interface

You can now call SourceTree.exe from wherever you installed it on the command line, and by default it will open up the nearest containing repository for your current directory. You can also specify a different path, and ask SourceTree to immediately navigate to certain views or run certain commands, like so:

SourceTree [-f path] [ <command> [<command_params>] ]
clone <url>
Opens the clone dialog with the provided URL.
Opens the repository at the File Status view.
Opens the repository at the Log view
search [<pattern>]
Opens the repository at the Search view. If <pattern> is specified, immediately searches for that text.
filelog <file>
Opens the repository and then opens the log for <file>.
Opens the repository and immediately goes to the commit dialog.




Thanks to your response to our call for translators, SourceTree for Windows 1.4 now comes in six languages: English, Japanese, Chinese, French, German, and Russian. The latter three are not 100 percent complete yet, but the major elements are translated; If you’d like to help fill in the remaining blanks, please join in the translation effort!

Patch file support

You can now create and apply patches within SourceTree – You can work effectively with patches comprised of uncommitted working state, and with patches containing one or more complete commits. SourceTree gathers all the options for generating a patch into an easy interface, and does the work of recognizing the relative paths and strip options when you’re applying a patch so you don’t have to work it out manually.

You can find the patch features on the Actions menu, labelled Create Patch and Apply Patch.

Archive support

Would you like to export a full copy of your source without all the Git/Mercurial history and metadata, either at the current state or at some other point in history? Archive is the feature you need for that, available either on the main menu (Repository > Archive), or on the context menu against a commit in the log (right-click a commit and pick Archive).


We want to make SourceTree an even better product for you, and to do this we’d love your help in finding out how you use our product. In the latest version 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.


We also added a bunch of other smaller things, such as:


We hope you like the new version of SourceTree for Windows!

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.