Does an image embedded on an article look different than what you see in the Confluence page view? Learn what causes you images to display differently and how to adjust them for your articles in Viewport.

Symptom/Problem

Explanation

Resolution

The image looks smaller than on the Confluence page.

There are two possible explanations:

  1. The original width of your image might exceed the width of the article content column. In that case, Viewport will automatically reduce your image width to fit the column width on the particular device that is used.

  2. The original height of your image might exceed the allowed image height of 1000 pixels. In that case, Viewport will automatically cap the height of your image to 1000 pixels and adjust the width accordingly (to keep your original image proportions).

The only way to override the setmax-height: 1000px is by injecting custom CSS to your article pages.

Please note, to ensure the best possible reading experience and avoid overly long articles (especially on smaller devices), we recommend sticking to our image defaults.

Clicking on the image will allow to extend the image in fullscreen mode.

The image looks larger than on the Confluence page.

By default, Viewport will display images in their original size.

Manually adjusting the size of the image in the Confluence editor will not affect how the image displays in Viewport.


If you want to display images smaller than their original size you will need to reduce the size using an image editing tool, then upload the smaller image to your Confluence page (replacing the previous image).

The image is not wrapped around my text.

The ‘Wrap left’ and ‘wrap right’ option that is available in the Confluence editor is not supported in Scroll Viewport.

N/A

Learn more about image handling in Viewport and how you can control image size and alignment.