File Viewer for Bitbucket: view files of different formats in Bitbucket

By on December 29, 2015

File Viewer for Bitbucket Cloud is the winner of the Codegeist 2015 Atlassian hackathon, in the category Best Bitbucket add-on.

This guest post is written by Alexander Kuznetsov, one of the developers of File Viewer for Bitbucket Cloud and co-founder of StiltSoft, an Atlassian Verified vendor and Atlassian Expert. Alexander has seven years’ experience as a software developer, five of which have been developing add-ons for Atlassian platforms. He was also the runner-up of Codegeist 2012 for the Awesome Graphs for Bitbucket Server (Stash) add-on.  

With millions of developers on Bitbucket Cloud there is a huge demand for add-ons providing additional functionality. Earlier this year our team introduced Awesome Graphs for Bitbucket Cloud. Then later in October, we decided to participate in Atlassian Codegeist 2015 with the idea that Bitbucket Cloud users would appreciate the capability to view files of various formats directly on Bitbucket pages. That’s how we built File Viewer for Bitbucket Cloud.

File Viewer for Bitbucket Cloud

This add-on allows you to view 3D and 2D models, maps, tables, and PDF files that are a part of your repositories right in Bitbucket without downloading them.

It’s a pack of viewers that includes:

File Viewer adds a new button on the panel of the core Bitbucket viewer, the one you see when you click a file in the Source tab. That button is used to switch from the default view to seeing a file in the add-on viewer.


View PDF documents

While viewing files with the *.pdf extension, you can see how many pages there are in a PDF document. Pages are displayed one at a time and you can navigate between them.


View 3D and 2D models in STL and Autodesk Viewers

There are two viewers for 3D models – STL Viewer and Autodesk Viewer. The latter can be used to view 2D models as well. STL Viewer works with *.stl extension files and renders them as 3D models that you can spin and zoom. This viewer is opened when you select the ‘View as 3D model’ option.


Autodesk Viewer supports over 30 file formats. Using this viewer you can visualize and interact with 2D and 3D design data. To open it, select the ‘View in Autodesk Viewer’ option.


View CSV and TSV documents

Table Viewer presents CSV and TSV files as tables with header and sorting capability.


View Maps

Map Viewer displays files with the *.geojson extension as maps that you can zoom and interact with (i.e. click it).


Try it

You can try File Viewer for Bitbucket Cloud by installing the add-on from the Find new add-ons section in your Bitbucket Cloud personal account settings. File Viewer doesn’t require any configuration. Once installed, you can start using it right away. Navigate to the Source section on the left-hand sidebar in your repository, locate a file you would like to view and select the viewer option in the ‘Default File Viewer’ menu.

We’d love to hear from you. If you have feature requests or feedback you would like to share, please contact us or post your ideas at the File Viewer forum.


  • Radek
    Posted December 29, 2015 at 11:38 pm | Permalink

    There are no format like .dwg and .dxf in Autodesk Viewer?

  • Royi
    Posted January 3, 2016 at 10:53 pm | Permalink

    Could you make a MarkDown viewer which supports MathJax?

    Something like SrackEdit.

    Thank You.

    • Katerina Kolina
      Posted January 4, 2016 at 4:59 am | Permalink

      Hi Royi,

      At the moment we are gathering feedback from File Viewer users and prioritizing our backlog, so thank you for your request. Your idea was added to the File Viewer forum, where users can post their feature requests and vote for the ideas shared by others.

      Here is the link to your idea

      Please vote for it. Based on how many votes it gets, we will know whether it is a highly demanded viewer or not and will be able to make a decision about developing it.

      Thank you.

      Kind regards,
      Katerina Kolina

  • Igor Baidiuk
    Posted January 4, 2016 at 11:00 am | Permalink


    Any chances for your presence on public issue tracker? It looks totally abandoned and ignored.

    • Katerina Kolina
      Posted January 5, 2016 at 3:45 am | Permalink

      Hi Igor,

      Sorry, I am not sure I understood what you meant. Could you explain?

      Kind regards,
      Katerina Kolina

      • Igor Baidiuk
        Posted January 5, 2016 at 4:31 am | Permalink

        Hi Katerina,

        I mean, there are several highly-voted user requests on . Including some requests for opting out of some recently forced features. Yet, this public tracker looks completely ignored by Bitbucket staff. So it would be really nice to know whether you look at those issues at all.

        First example:

        By adding this feature, Bitbucket team broke CI for some users and added unneeded annoyance for the others. And no response for about 6 months.

        Other examples:
        These are three top-voted feature requests, which exist for several years, with zero attention from Bitbucket team.

        Nobody expects immediate implementation for these. But complete ignorance isn’t nice either.

        Igor Baidiuk

        • Katerina Kolina
          Posted January 5, 2016 at 6:12 am | Permalink

          Hi Igor,

          Thank you for clarifying what you meant. Yes, our team is checking the Bitbucket Cloud issue tracker from time to time and we are aware of those highly demanded requests. Though I have not participated in those discussions yet.

          Being an Atlassian vendor, we can’t influence the way the Bitbucket team prioritizes the issues in their backlog, but the participation of everyone contributes to getting major issues addressed faster.

          We are developing Awesome Graphs for Bitbucket Cloud and it is valuable to have the discussions in some of those issue to learn what kind of statistics and graphs Bitbucket users need.

          Kind regards,
          Katerina Kolina

          • Igor Baidiuk
            Posted January 12, 2016 at 1:19 am | Permalink

            Hi Katerina,

            Don’t get me wrong, but your answer can be squashed to
            “I’m not from Bitbucket core team, and I have no info on what’s going on there”.
            Surely it’s not your fault, but it would be really nice to hear someone from that team. Because people I hear on issue tracker are coming to conclusion that those guys are completely deaf to users.

            Kind regards,
            Igor Baidiuk

  • Jacky
    Posted January 5, 2016 at 1:37 am | Permalink

    Any idea to support PlantUML file view?