Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Recommended Best Practices for working with images on Confluence pages

I can't seem to find any documented recommendations about adding images to Confluence pages to get the best results. I have been just copying and pasting in images because that's the fastest way to do it, but sometimes the image quality doesn't look great later. I'm getting ready to go through and redo my screenshots now that I have more time.

Is there a recommended size and DPI we should use (I'm guessing probably 300 DPI for the types of images I'm using, which are mostly screenshots) and method for inserting them?



2 answers

0 votes
Owen Wallis Atlassian Team Jan 27, 2021

Hi @Laura McWilliams,

Thanks for your question. The key thing you want to be looking at in the image is pixel size (rather than dpi).

The width of a normal page in Confluence is 760px. So if you upload an image say of 640px it will appear floating in the middle of the page. If you then stretch that image to be the same width as the page you'll start seeing some degradation.

If you upload an image wider than 760px it will fill the width of the page container. 

If you set your page to full width it stretches to whatever size your monitor is set to. So you'll want to be uploading really big images if you have a really big monitor!

Hi @Owen Wallis thanks so much for your response.

Most of my images are about 800 pixels wide, and it's surprising to me that they are wider than the default confluence page size b/c I thought that was pretty narrow. However, my computer has a retina screen which is pretty high-res so maybe that's why. I always use my built-in screen for screenshots b/c I want to make sure it will fit on a smaller screen; my separate monitor is HUGE.

I think my bigger issue is that I can't seem to control the size the images display at. I want them to be a fixed size based on the actual size of the picture. But when I bring them into Confluence, they seem to automatically resize. The biggest issue is when I screenshot a dialog window which should be narrower than the main window. I might use something closer to 400-500 pixels wide. When I import it to Confluence it automatically resizes to be the same size as the other screenshots. Then the only way I can seem to resize it is by dragging those bars. I don't want to have to drag it around to resize, I just want the image to show up in actual size. That way the relative sizes of all the images will be correct. How can I do that?

Owen Wallis Atlassian Team Jan 28, 2021

Hi Laura,

The ability to resize images by pixels is not on the new editor just yet.

You can watch the related ticket here for updates:

It has a lot of votes and the team here is aware of the need of this feature.

Hope you can continue to work with dragging to resize in the meantime.

All the best


0 votes
Matt Reiner _K15t_ Marketplace Partner Jan 25, 2021

My team put together this page on things to consider when adding images:

Unfortunately, we didn't' touch on size or DPI. 🙁 I'll see if we can circle back to add that. In general, we try to follow website best practices: 

Thanks for the reply. It's nice information but not really specific to my problem.

I think I'm having a more general problem with Confluence. I can't seem to control the image size at all. I thought maybe the problem has to do with using Control-V to paste in images, so I switched over to using the "add image" button. But it does really weird things, and I'm starting to suspect this is why some of my images don't look great later on.

I will create an image that is just the size I want for optimal display, but when I insert it into the Confluence page, it resizes it automatically, and I can't seem to find anyway to actually set it to display the image at actual size. This is getting really frustrating and I don't understand why Confluence itself doesn't seem to have any documentation about itself.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

Confluence Mythbusters: Does Atlassian even use Confluence?

Hi, Confluence collaborators! As part of #Confluence-Collaboratory month, we’ve created a very special Mythsbusters segment, where we're dive into an interesting myth and uncover the truth behind i...

1,367 views 7 28
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you