Limit the impact of Image Effects on Confluence
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Image Effects within Confluence allows you to customize the display of any attached image to make it look fancy. However, on some occasions, that image might be too big in size or too big in the number of pixels. This might create a CPU spike for Confluence when applying those effects.
We already have a bug to track this CONFSERVER-55200 - Unable to apply image effects to dimensionally large images.
Solution
The solution to this is to limit the impact of those images on the stability of your environment. See Configuring System Properties to find out how to apply a system property in your environment.
This system property will prevent the image effects from processing an image larger than 1MB
1
-Datlassian.image_filter.transform.max_data_size=1000000This system property will prevent the image effects from processing an image that has more than 4000x4000 pixels as a resolution
1
-Datlassian.image_filter.transform.max.pixel=4000From Confluence 7.7, an additional system property atlassian.image_filter.transform.max.pixel.drop_shadow applies to the drop shadow image effect. This property introduces an even lower pixel limit when attempting to apply a drop shadow.
Was this helpful?