How to add images to Readme.md

[Abhijit Tomar]

Hello,

I am trying to add some images to my Readme.md file as


but its not working. when i view the readme, all i see is the plain text


please help

[Mibex_Software · Accepted solution]

Hi,

You can include an image by specifying the path relative to your repository root directory:


Hope this helps.

Cheers,

Michael

[Abhijit Tomar]

thanks michael but i still get the plaintext  also, i cant seem to be able to escape quotes. i tried using \' but this shows up as \' does stash render markdowns differently ?

[Mibex_Software]

I've just checked it again:  works as intended. Do you have it on a separate line?

[ipashchenko]

No, it doesn't show image in README on project page. I've tryied both relative links and absolute path to dropbox hosted image (http://*.png) - doesn't work... This is sad. 

[Matt Rakestraw]

Ilya, I was having same problem. If I removed all space in front of the tag, my image started showing up. Apparently, you can't indent.

[vdkhanh]


This worked for me.

[NONE]

I had the same problem and tried a lot (relative path, upper/lowercase etc.).

What solved it finally was adding the alternative text.

As Michael said, this is a valid format working locally in editor preview and remote on Stash/Bitbucket:

![alternativetext](subfolder/image.png)

[Boujraf Youssef]

Dear all,

Same problem since new version of bitbucket.

Last week, no issue to display the picture.

Now, the issue is the picture is not displayed.

To get back the picture, we need :

- Edit the readme.md file

- press CANCEL

Then the picture is displayed again.

 

the path is : 

Thanks if anybody could highlight me about this.

Best regards,

Youssef

[techrisala]

Changing my comment to STILL NOT WORKING.

[Ian Geiser]

It still will not render correctly on the overview page.

[Boujraf Youssef]

Dear

Yest it is.

Without :

- Edit the readme.md file

- press CANCEL

No pictures.

Best Regards,

Youssef

[Michael Neil]

This does not work as intended. Maybe it's working in existing README's but not new ones.

I added an image to my repo in a folder. I added the markdown


When I view my readme on bitbucket I get a broken image link. I opened the inspector and the path/image are correct! The file is requested and returns a 200. Except that the content type is text/html :(

It appears that the markdown parser is interpreting the code incorrectly.

[techrisala]

@Boujraf Youssef Your fix works temporarily. On reloading the page, the images get lost again.

[surreal6]

same problem here, it was working but with the new design the images disappeared...

[Mike Makuch]

Same problem here

[lionslair]

Anyone work this out yet?

[Noah Rodenbeek]

I'm having the same issue. It does work if I go to the Readme file, push Edit, then push Cancel. Otherwise, it's just showing the alt-text and a broken image icon. I mean, if nothing else, can the broken image icon go away and the alt text just behave like it normally would on a website?

[anaqui]

It does work, but the problem is it only works in the master branch. If you have a feature branch and try to test it out, it will appear as a broken link. When you merge to the master, your image will show up. Atlassian should fix this.

[Mark Bonsack]

Not only does it only work in the master branch, the image still won't display.  You  have to actually click on the alternate text (which is hyperlinked) to the image file, which then displays properly in a new window.

EDIT:  I had an extra [] pair around the alt-text; weird behavior for sure... 

But still only works with master.

[hansiemithun]

can we specify the width and height on this: ``

[Mikko Salonen]

Get the full path by navigating to your image file, push 'raw file'-button right of the page, copy the path except for the very end (e.g. image.png?at=refs%2Fheads%2Fmaster). In general the path should be https://......../[project_name]/raw/[image_folder]/[image.png]

[bdore]

This works.

[Samuel Ferreira]

This works only in preview mode (while editing the README.md file inside the bitbucket itself)

[arshak49]

Thank you a lot. 

[DesolanceR]

This works for me:


ImgName = whatever you want

AbsoluteURL = can copy this from browser, go to the image in your repository, open it and copy the link

ex: https://bitbucket.org/*USER*/*PROJECT*/src/master/.../image.png

ModifiedAbsoluteURL = Take the AbsoluteURL and replace "src" with "raw"

Now your image should be displayed in the ReadMe.

[osman]

Worked for me after trying a million other things. Thanks!

[docamp10]

Worked for me. Thanks!

[Liz Medelez]

Thank you very much! this solution worked for me.

[Dmitry]

thx very match, u r a wizard! Works in 2021

[Marcy]

In each repo's Issue Tracker under Settings, I added an image to the "No issue tracker":

That provided a link that I copied and pasted into the repo's Readme.md file. This works for me and is the same technique some use on GitHub.

[Not Angel Ortiz]

A relative path works just fine, if you are on the master branch.

![alt_text](images/your_image_name.png)

I changed the README.md file in the development branch, but when pushing changes the images are not showing up. The reason is: because BitBucket looks for the raw images in the master branch.

[Sidh Regmi]

 works.

Apparently, it was due to case sensitivity in my case. Changing jpg to caps worked on my test repo. So make sure your path and name of the file is exactly as it is in the repo.

[qbrt]

Aparently, bitbucket does not like the minus character when trying to embed an image into a markdown file.

This does NOT  work (has minus char in filename)

 works in bitbucket.

This works (minus char removed)

 works in bitbucket.

Cheers

[arpit.malhotra]

Could you please tell me how can I directly upload an image to an existing directory. I can add images to a comment description but I don't see a way to add it to any repo.

[Sidh Regmi]

You would have to push the image to the repo same way you'd push the code. Cannot add image from the bitbucket UI. You'd have to do it either using sourcetree or git commandline.

[Keith Hill]

Has anybody been able to figure out how to get an embeddable build badge to show up in a README?  What we had used to work just fine but since our last Bitbucket server upgrade, it has broken **all** of our README build badges.  This is a #FAIL.

We use Jenkins for builds and its build status images are all served via a URL containing an SVG element. 

[Keith Hill]

Hmm,  I think the cause of my problem is that our Jenkins master is HTTP while our Bitbucket server is HTTPS:

https://github.com/jenkinsci/embeddable-build-status-plugin/issues/43#issuecomment-640723861

[Keith Hill]

Was able to fix this in the browser, following this answer to a S.O. post: https://stackoverflow.com/questions/40696280/unsafely-treat-insecure-origin-as-secure-flag-is-not-working-on-chrome/53388534#53388534

[Simon Hooper]

Check the case of both the path and filename are correct.

I had trouble getting a swagger screenshot to load in our readme.md on bitbucket server. The image was one folder deep from root in the resource folder. Resources/SwaggerUI.PNG

When looking at the md file I had, I noted that the case of the path and file name was wrong.

So `resources/swaggerui.png` did not work but setting the correct case did `Resources/SwaggerUI.PNG` 

## Swagger
Check![SwaggerUI.png](Resources/SwaggerUI.PNG)

[Tim Black]

Simon, I'm also using Bitbucket Server and can only get images to work in markdown when using paths relative to the current file. repo-relative paths don't work, and external links dont work. Is this your experience as well?

It's rather unfortunate, bc it forces us to put images in our git repos, which is less than ideal. I'm using png exported from draw.io - it would be better if I could refer to the file stored elsewhere IMO.

I don't see anywhere in Bitbucket docs or in community about this limitation.

[Simon Hooper]

Yeah our readme is at root too. So we're in the same boat. Could only get the image to render when the path is relative but also when the case matched.

It's rather unfortunate, bc it forces us to put images in our git repos, which is less than ideal. I'm using png exported from draw.io - it would be better if I could refer to the file stored elsewhere IMO.

Could not agree more.

[david]

It is 2020, is there any way to resize on bb?

[DS]

Shouldn't Bitbucket work to support base64 encoded images just like similar readme viewers and editors do?

[Adam Pankowski]

Removing spaces from the paths solve this issue for me. Still surprising that in 2k19 we still got issues with spaces inside the path.

[Pedro Freitas]

How does Atlassian even dare to claim projects are migrating from GitHub into here if it does not support such simple feature...

[Srikrushna Pal]

It's very simple

Just upload your image to the repository root, and link to the filename without any path, like so:

![your_image_name](your_image_name.png)

[Dwayne]

This worked for me. I used the absolute path suggested by @Mikko Salonen along with the following format:

.. figure:: https://absolute/path/to/image.png
   :alt: alias of image