Select a specific derivative image or video

By default, Image and Video Manager uses sophisticated algorithms to determine the best derivative to serve. There may be cases, however, where you want to select a specific derivative image or video. To do so, use select query parameters to override the Image and Video Manager algorithms.

A list of query string parameters is provided in the table that follows. Parameters can be applied using either the Image and Video Manager Set Parameters behavior or by incorporating the parameters into the image URLs on your website.

You can apply multiple parameters simultaneously using:

  • Set Parameters behavior. Add multiple instances of the behavior to the rule and select a different parameter in each instance.

  • Query string parameters. Join multiple parameters with the ampersand character:

.../product/item12345.jpg?impolicy=mypolicy&imformat=chrome

📘

Many content management systems (CMS) include features for inserting query string parameters into image URLs. Consult your CMS documentation for more information.

Key

Function

Syntax Example

impolicy

Apply the specified Image and Video Manager policy. If no valid policy name is specified, Image and Video Manager applies the default policy.

To apply the policy for thumbnails:
?impolicy=thumb

imwidth

Image: Serve the image in the specified width. If the applied policy does not include that width, serve the next largest.

Video: Serve the video resolution using the width specified in the policy (for example, 854, 1280, or 1920 pixels). If the applied policy does not include that width, serve the next largest.

Image: To serve the image that is 320 px wide:
?imwidth=320

Video: To serve a video that is 1280 px wide:
?imwidth=1280

imformat

Image: Force Image and Video Manager to serve the image in the browser-optimized format specified. Use this to override the one-touch feature Use Best File Type. Permitted values are: chrome, safari, generic.

Video: Force Image and Video Manager to serve the video using the encoding format specified. Permitted values are: h264, h265, vp9.

Image: To serve the image optimized for Safari browsers:
<?imformat=safari

Video: To serve the video optimized using the h264 encoding format:
?imformat=h264

imdensity

Image: The imdensity parameter specifies the pixel density to use for the given request.

Serves an image using the appropriate resolution for the end device by multiplying the imdensity value by the imwidth value.

The pixel density is expressed as a multiplier where the value 1 is normal density.

To represent a pixel density 2.4 times the normal density for the given request:
?imdensity=2.4


Did this page help you?