GuideReference
TrainingSupportCommunity
Guide

adaptive_​image_​compression


Note: Starting from May 31, 2024, Adaptive Image Compression is no longer supported and the image compression configured through this functionality won't take place. As an alternative, we offer Image & Video Manager. It intelligently and automatically optimizes images and videos on the fly for every user. Reach out to your Akamai representatives for more information on this product.

The Adaptive Image Compression feature compresses JPEG images depending on the requesting network's performance, thus improving response time. The behavior specifies three performance tiers based on round-trip tests: 1 for excellent, 2 for good, and 3 for poor. It assigns separate performance criteria for mobile (cellular) and non-mobile networks, which the compress_​mobile and compress_​standard options enable independently.

There are six method options, one for each tier and type of network. If the method is COMPRESS, choose from among the six corresponding slider options to specify a percentage. As an alternative to compression, setting the method to STRIP removes unnecessary application-generated metadata from the image. Setting the method to BYPASS serves clients the original image.

The behavior serves ETags headers as a data signature for each adapted variation. In case of error or if the file size increases, the behavior serves the original image file. Flushing the original image from the edge cache also flushes adapted variants. The behavior applies to the following image file extensions: jpg, jpeg, jpe, jif, jfif, and jfi.

OptionTypeDescriptionRequires
compress_​mobileboolean

Adapts images served over cellular mobile networks.

{"displayType":"boolean","tag":"input","type":"checkbox"}
tier1mobile_​compression_​methodenum

Specifies tier-1 behavior.

compress_​mobile is true
{"displayType":"enum","options":["COMPRESS","BYPASS","STRIP"],"tag":"select"}
{"if":{"attribute":"compressMobile","op":"eq","value":true}}
Supported values:
BYPASS
COMPRESS
STRIP
tier1mobile_​compression_​valuenumber (0-100)

Specifies the compression percentage.

tier1mobile_​compression_​method is COMPRESS
{"displayType":"number","max":[100],"min":[0],"tag":"input","type":"range"}
{"if":{"attribute":"tier1MobileCompressionMethod","op":"eq","value":"COMPRESS"}}
tier2mobile_​compression_​methodenum

Specifies tier-2 cellular-network behavior.

compress_​mobile is true
{"displayType":"enum","options":["COMPRESS","BYPASS","STRIP"],"tag":"select"}
{"if":{"attribute":"compressMobile","op":"eq","value":true}}
Supported values:
BYPASS
COMPRESS
STRIP
tier2mobile_​compression_​valuenumber (0-100)

Specifies the compression percentage.

tier2mobile_​compression_​method is COMPRESS
{"displayType":"number","max":[100],"min":[0],"tag":"input","type":"range"}
{"if":{"attribute":"tier2MobileCompressionMethod","op":"eq","value":"COMPRESS"}}
tier3mobile_​compression_​methodenum

Specifies tier-3 cellular-network behavior.

compress_​mobile is true
{"displayType":"enum","options":["COMPRESS","BYPASS","STRIP"],"tag":"select"}
{"if":{"attribute":"compressMobile","op":"eq","value":true}}
Supported values:
BYPASS
COMPRESS
STRIP
tier3mobile_​compression_​valuenumber (0-100)

Specifies the compression percentage.

tier3mobile_​compression_​method is COMPRESS
{"displayType":"number","max":[100],"min":[0],"tag":"input","type":"range"}
{"if":{"attribute":"tier3MobileCompressionMethod","op":"eq","value":"COMPRESS"}}
compress_​standardboolean

Adapts images served over non-cellular networks.

{"displayType":"boolean","tag":"input","type":"checkbox"}
tier1standard_​compression_​methodenum

Specifies tier-1 non-cellular network behavior.

compress_​standard is true
{"displayType":"enum","options":["COMPRESS","BYPASS","STRIP"],"tag":"select"}
{"if":{"attribute":"compressStandard","op":"eq","value":true}}
Supported values:
BYPASS
COMPRESS
STRIP
tier1standard_​compression_​valuenumber (0-100)

Specifies the compression percentage.

tier1standard_​compression_​method is COMPRESS
{"displayType":"number","max":[100],"min":[0],"tag":"input","type":"range"}
{"if":{"attribute":"tier1StandardCompressionMethod","op":"eq","value":"COMPRESS"}}
tier2standard_​compression_​methodenum

Specifies tier-2 non-cellular network behavior.

compress_​standard is true
{"displayType":"enum","options":["COMPRESS","BYPASS","STRIP"],"tag":"select"}
{"if":{"attribute":"compressStandard","op":"eq","value":true}}
Supported values:
BYPASS
COMPRESS
STRIP
tier2standard_​compression_​valuenumber (0-100)

Specifies the compression percentage.

tier2standard_​compression_​method is COMPRESS
{"displayType":"number","max":[100],"min":[0],"tag":"input","type":"range"}
{"if":{"attribute":"tier2StandardCompressionMethod","op":"eq","value":"COMPRESS"}}
tier3standard_​compression_​methodenum

Specifies tier-3 non-cellular network behavior.

compress_​standard is true
{"displayType":"enum","options":["COMPRESS","BYPASS","STRIP"],"tag":"select"}
{"if":{"attribute":"compressStandard","op":"eq","value":true}}
Supported values:
BYPASS
COMPRESS
STRIP
tier3standard_​compression_​valuenumber (0-100)

Specifies the compression percentage.

tier3standard_​compression_​method is COMPRESS
{"displayType":"number","max":[100],"min":[0],"tag":"input","type":"range"}
{"if":{"attribute":"tier3StandardCompressionMethod","op":"eq","value":"COMPRESS"}}