--- title: "Media transformations" slug: "media-transformations" abstract: "How to use media transformation parameters with public links in Content Hub." --- # Media transformations Content Hub lets you transform media (such as images, photos, or artwork) by appending parameters to the URL generated when you create a [public link](https://doc.sitecore.com/ch/en/developers/cloud-dev/public-links.html "Public links"). > [!note] > You can create a public link on all [asset types](https://doc.sitecore.com/ch/en/users/content-hub/asset-media-types.html). Media transformations, however, are only supported with the following file formats: `jpeg`, `png`, `gif` (including animations), `webP` (including animations), and `heic`. > > Media transformation parameters are case sensitive. When adding them to the URL format, you must also append `transform=true`. Here are some examples of common media transformations. The list is not exhaustive. For the full list of available transformations, see the [Cloudflare documentation](https://developers.cloudflare.com/images/optimization/features/#parameters). ## background Adds a background color underneath the image. This parameter applies only to images with transparency (for example, PNG files). You can use a hex code to specify the background color (for example, `background=%23FF0000`) or the color itself (for example, `background=red`). **URL format** ```shell /api/public/content/?background=red&transform=true ``` ![A transparent image of a heart with a red background applied](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/background-parameter-result.png) ## blur Applies blurring to the entire image. The intensity of the blur is determined by the parameter value, which can range from 1 (lowest) to 250 (highest). **URL format** ```shell /api/public/content/?blur=50&transform=true ``` ![blur parameter result](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/blur_parameter_result.png) ## brightness Multiplies the brightness level of the image by a factor, where a value of 1.0 equals no change, a value of 0.5 equals half brightness, and a value of 2.0 equals twice as bright. The value must be greater than 0. **URL format** ```shell /api/public/content/?brightness=2.0&transform=true ``` ![brightness parameter result](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/brightness_parameter_result.png) ## contrast Multiplies the contrast level of the image by a factor, where a value of 1.0 equals no change, a value of 0.5 equals lower contrast, and a value of 2.0 equals higher contrast. The value must be greater than 0. **URL format** ```shell /api/public/content//?contrast=0.5&transform=true ``` ![contrast parameter result](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/contrast_parameter_result.png) ## fit Affects how the image is resized and works in conjunction with the image width or height. All resizing modes preserve the original aspect ratio. The available modes are: - `contain` - resizes the image to be as large as possible within the given `width` or `height` while preserving the aspect ratio. If you only provide a single dimension (for example, only the `width`), the image is resized to exactly match that dimension. - `cover` - resizes the image to fill the entire area of width and height. If the image has an aspect ratio different from the ratio of width and height, it is cropped to fit. - `crop` - shrinks and crops the image to fit within the area specified by width and height. The image is never enlarged by this mode. For images smaller than the given dimensions, it is the same as scale-down. For images larger than the given dimensions, it is the same as cover. - `scale-down` - similar to `contain`, but the image is never enlarged. If the image is larger than the given `width` or `height`, it will be resized. Otherwise, its original size is kept. **URL format** ```shell /api/content/public//?width=150&fit=crop&transform=true ``` ## gamma Increases the image exposure by a factor, where a value of 1.0 equals no change, a value of 0.5 darkens the image, and a value of 2.0 lightens the image. 0 is ignored. **URL format** ```shell /api/content/public//?gamma=0.5&transform=true ``` ![gamma parameter result](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/gamma_parameter_result.png) ## gravity Use when cropping an image with `fit=cover` or `fit=crop`. This parameter defines the side or point that should not be cropped. Options are: - `gravity=auto` - selects a focal point based on saliency detection (using maximum symmetric surround algorithm). - `gravity={SIDE}` - selects a side (`gravity=left`, `gravity=right`, `gravity=top`, `gravity=bottom`), which will not be cropped. - `gravity={COORDINATES}` - selects coordinates specified on a scale from `0.0` (top or left) to `1.0` (bottom or right), `0.5` being the center, around which the image is cropped. The X and Y coordinates must be separated by lowercase `x` in the URL. For example, `0x1` refers to the bottom left corner, `0.5x0.5` refers to the exact center, and **0.5x0.33** refers to a point in the top third of the image. **URL format** ```shell /api/public/content//?gravity=right&fit=cover&height=150&width=100&transform=true ``` ![gravity parameter result](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/gravity_parameter_result.png) ## height Sets the maximum height of the image in pixels. Exact behavior depends on the fit mode. **URL format** ```shell /api/public/content/?height=150&fit=cover&transform=true ``` ## rotate Rotates the image by 90, 180, or 270 degrees. **URL format** ```shell /api/public/content/?rotate=90&transform=true ``` ![rotate parameter result](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/rotate_parameter_result.png) ## sharpen Applies a sharpening filter to the entire image. The intensity of this filter is determined by the parameter value, which can range from 0 (none) to 10. **URL format** ```shell /api/public/content/?sharpen=3&transform=true ``` ## trim Trims one or more edges of the image by a specified number of pixels using the format `top;right;bottom;left`, such as 100;0;100;0. This transformation is applied before any resizing or rotation of the image, and it takes DPR into account. In the following example, the top of the image is trimmed by 800 pixels. **URL format** ```shell /api/public/content//?trim=800;0;0;0&transform=true ``` ![trim parameter result](https://doc.sitecore.com/api/markdown-image/ch/en/developers/cloud-dev/images/trim_parameter_result.png) ## width Sets the maximum width of the image in pixels. Exact behavior depends on the fit mode. **URL format** ```shell /api/public/content//?width=50&fit=cover&transform=true ```