Referenced image is the wrong size on a published site

What you are seeing

An image you added with the Image reference macro looks a different size on your published site than it does in Confluence.


#Why it happens

The site publisher keeps the alignment, caption, corner radius, shadow and border. It ignores Width, Height and Aspect Ratio, so the image takes on your site's own image styling instead.


#What to do

If the exact published size matters, resize the image itself before you upload it.


#Settings involved

Setting

Where

What it does

Global settings → Capabilities

Confluence admin → Apps → Capable → Settings → Capabilities

-

Global settings → Asset access (Permissi

Capable settings → Asset access

-

Global settings → Egress

Capable settings → Egress

-


#Limits that apply here

Limit

Value

What happens

Upload. Drag and drop accepted extensions.

Bmp, gif, ico, jfif, jpeg, jpg, png, svg

Anything else raises 'Invalid file type. Only image files are allowed'.

General image compression target

5 MB and 2500 px on the longest side

-

Editor / attachment-import fetch ceiling

3 MB

An attachment loaded for editing or importing into the library can be up to 3 MB. Larger files are resized automatically. Only if that still fails do you see 'Image too large for editor (N MB). Max 3MB.'.



Found it? Good.