When you create share links and embed codes, you can further customize the size of share links and embed codes for images by changing the width, height, cropping (the keep area), or padding in the HTML.


Here's example HTML, and the text in bold is what you'll alter to create customized links or embed codes for:


Image size

Specify image size as exact width or exact height where the opposing side pixel value will be dynamically calculated to maintain the image's aspect ratio. The entry for exact width of 425 pixels is 425px. The entry for exact height should start with a prefixed "x" - for example, x425px.


For an exact sized image, specify the width first, then the height, separated by an "x." An image with a size of 460 pixels in width by 520 pixels in height is entered as "460x520px." Refer to the crop area values information below for details on how exact sized images will be transformed.


By default, images can be sized up to 2,048 pixels constrained to the longest side. If a larger size is needed, the original parameter can be used and images can then be sized up to the size of the original file. Note that using this parameter may cause longer load times because the larger file is used to create the image.

A scale factor can be added to easily generated, retina-optimized images. For a scale factor of two, add "@2x" immediately after the size entry. The scale factor can be any numeric value (e.g., 1.5, 2, 4). If a scale factor is not specified, it defaults to a value of one. For example, an image requested at "460x520px@2x" will be delivered with final pixel dimensions of 920 x 1,040 pixels. For retina-optimized images, image width or height, including the scaling factor, can never be larger than 5,120 pixels.

You can also select the original size option, which sets the width and height for the image at the same size as the original format. For original images, "source=original" should be added to the end of the code like in this example: https://embed.widencdn.net/img/demo/xljsxjjqic/2048px/BannerImage.jpg?source=original.


Filename

The filename ({filename}) can be any non-empty value. The filename value is not processed by the image server, but it is recommended to use a description value for search engine optimization purposes.


Image format

The image format ({format}) can be GIF, JPEG, JPG, or PNG. GIF or PNG formats are best used with logo and line art images. Use JPEG for photographic images.


Options

Options are specified as URL query parameters. Immediately after the image format, add a question mark (?). Additional options are separated by the ampersand ( & ). A equals ( = ) sign is used to separate the option name from the option's value.


Image quality

Name: quality or "q"
Default: 80
Value: Integer from 0 (lowest quality) to 100 (highest quality)

Image quality applies only to JPEG format images.


Crop area values

Name: crop or "c"
Default: True

Value: Boolean value. "1," "true," or "yes" for true. "0," "false," or "no" for false.


Crop area values are valid when you specify the image width and height. When true, the image is cropped to fit the aspect ratio of the requested size. When false, the image is created with additional background area.

Keep area values

Name: keep or "k"
Default: center
Value:
"c" = center
"n" = north
"ne" = northeast
"e" = east
"se" = southeast
"s" = south
"sw" = southwest
"w" = west
"nw" = northwest

When you set the crop value to true, the primary area preserved is controlled by the keep value.

Background color values

Name: color or "co"
Default: ffffff (white)
Value: RGB color value specified as in HEX format

When you set the crop option to false, additional background areas are created with the specified color. Example HTML color codes are available.