Selecting a Specific Derivative

By default, Image and Video Manager uses sophisticated algorithms to determine the best derivative to serve. You can use select query parameters to override Image and Video Manager’s algorithms and select a specific derivative image or video instead.

See the Available Image and Video Manager Parameters below for details. Parameters can be applied either with the “Image and Video Manager: Set Parameters” behavior or by incorporating query string parameters in the image URLs on your site.

You can apply multiple parameters simultaneously:

  • With the Set Parameters behavior, simply add multiple instances of the behavior in the same rule, and select a different Parameter in each instance.
  • With query string parameters, join multiple parameters with the ampersand character: .../product/item12345.jpg?impolicy=mypolicy&imformat=chrome
    Note: Many content management systems include features for inserting query string parameters into image URLs. Consult your CMS documentation for more information.
    Available Image and Video Manager Parameters
    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 auto policy. To apply the policy for thumbnails:

    ?impolicy=thumb

    imwidth Serve the image in the specified width (in pixels). If the applied policy does not include that width, serve the next largest. To serve the image that is 320 px wide:

    ?imwidth=320

    Serve the video resolution using the width in pixels specified in the policy (854, 1280, or 1920). If the applied policy does not include that width, serve the next largest. To serve a video that is 1280 px wide:

    ?imwidth=1280

    imformat 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. Allowed values are: chrome, safari, generic. To serve the image optimized for Safari browsers:

    ?imformat=safari

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

    ?imformat=h264

    imdensity 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