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.


  • Posted February 12, 2014 at 10:47 am | Permalink

    Will there be an option to disable this? While they can be helpful, I usually find they devolve into some weird “meme off” and dilute the value of a comment thread.

    • j
      Posted February 12, 2014 at 11:15 am | Permalink

      I support making it optional. That said, I must admit the temptation to post a choice meme pic here in my reply was almost too great to resist… but I triumphed 🙂

    • Guest
      Posted February 20, 2014 at 7:56 am | Permalink

      This commend makes me sad.

  • avatar uploader
    Posted February 12, 2014 at 11:54 am | Permalink

    try to upload avatar in account settings:

    Upload avatar

    There was an error uploading your image

    The selected image size is %(image_width)dpx * %(image_height)dpx. The
    maximum allowed image size is %(max_dimension)dpx *

    • Anonymous
      Posted February 12, 2014 at 5:29 pm | Permalink

      Please come to with the specifics. If you can, please attach the exact image you tried to upload, as well as the repository where you see the error.

      • pakuize
        Posted February 15, 2014 at 5:42 pm | Permalink

        It might just be me but it would seem as if he did say his account avatar not a comment on a commit.

        However I do love this update it does add a good extra layer instead of using more tools or mail pictures with error back and forth.

  • Posted February 12, 2014 at 2:50 pm | Permalink

    I’ve wanted this feature for a long time, thank you team!

  • Nick Davis
    Posted February 13, 2014 at 9:55 am | Permalink

    Eric Wareheim!

  • Posted February 18, 2014 at 8:51 am | Permalink

    Thanks BB!

  • Posted February 19, 2014 at 11:51 am | Permalink


  • Posted February 19, 2014 at 4:57 pm | Permalink

    Great work, first thing I tested and was not available. Now it is 😉

  • John Lim
    Posted February 25, 2014 at 8:04 pm | Permalink


    Thanks for the feature. I am currently using it for my wiki. However, how do I delete an image file after uploading it? Thanks.


  • Holger Schimanski
    Posted February 26, 2014 at 11:51 am | Permalink

    How about upload of movies and integrate them in comments of wiki pages? Screenflows are so easy to record with todays tools and can describe a problem even better than just screenshows.

  • Teacher
    Posted May 12, 2014 at 11:40 am | Permalink

    Test 🙂

  • Teacher
    Posted May 12, 2014 at 11:42 am | Permalink

    Test 1

  • Frick
    Posted April 12, 2015 at 6:47 pm | Permalink

    I want an avatar……lol

  • Frick
    Posted April 12, 2015 at 6:50 pm | Permalink

    ohhhh, lol now I have one hehe thanks!!!!

  • Kalani sharma
    Posted May 28, 2015 at 7:02 am | Permalink

    Upload, share, track, manage your files in one simple to use file host.

  • ilmgb
    Posted January 15, 2016 at 9:53 am | Permalink

    Is there a way to directly upload a screenshot (from the clipboard)? Thanks.

  • Matthis Thorade
    Posted April 27, 2016 at 5:06 am | Permalink

    I would like to upload an image into the repository via the web interface, is that possible too?