# Trim

Removes any single-color padding around the image if present.

The parameter does not specify the amount of border or frame to trim but rather how aggressive the trim algorithm should be. A bigger value of the parameter (e.g. 25) might trim part of the image. Typical values are between 0 and 10.

This allows you to use the same parameter values for all your images.

<mark style="color:orange;">**trim=X**</mark>

{% hint style="info" %}
If the image is resized with the **width** and/or **height** commands, the resizing is performed *after* the border (if present) is trimmed.
{% endhint %}

## Trim gravity

When **`gravity=trim`** is set alongside trim=X (for the [crop](https://docs.cloudimage.io/transformations/image-operations/crop "mention"), [fit](https://docs.cloudimage.io/transformations/image-operations/fit "mention") or [cropfit](https://docs.cloudimage.io/transformations/image-operations/cropfit "mention") operations), the focal point is defined depending on the trim result:

* When the image is trimmed on all sides, gravity is set to **center**;
* When no trim has been performed, gravity is set to **smart**;
* If the image has been trimmed on some edges only, the gravity is set to:
  * **fit** operation - gravity is set to the edges opposite of the trimmed ones so that the canvas is extended only on the trimmed sides;
  * **crop** operation - gravity is set to the trimmed edges so that the image is not cropped anymore on the trimmed edges.

## Examples

| Preview                                                                                            | Syntax                                                                                                                                                                                                                                                                                          |
| -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](https://content.gitbook.com/content/IDIcmPiz7q6Sr6ZHHQxV/blobs/7uq5kRHO3aL8eIKvNetn/image.png) | <p>Original image:<br><a href="https://doc.cloudimg.io/https://samples.scaleflex.com/painting_big.jpg?w=400">/samples.scaleflex.com/painting\_big.jpg?<mark style="color:orange;"><strong>w=400</strong></mark></a></p>                                                                         |
| ![](https://content.gitbook.com/content/IDIcmPiz7q6Sr6ZHHQxV/blobs/ApVa8se2FXSAN9jyxNGT/image.png) | <p>Trimmed image:<br><a href="https://doc.cloudimg.io/https://samples.scaleflex.com/painting_big.jpg?w=400&#x26;trim=10">/samples.scaleflex.com/painting\_big.jpg?<mark style="color:orange;"><strong>w=400</strong></mark>&<mark style="color:orange;"><strong>trim=10</strong></mark></a></p> |
| ![](https://content.gitbook.com/content/IDIcmPiz7q6Sr6ZHHQxV/blobs/O2pCYY0UI6u8Gv59R3iX/image.png) | <p>Original image:<br><a href="https://doc.cloudimg.io/https://samples.scaleflex.com/sofa.jpg?w=400">/samples.scaleflex.com/sofa.jpg?<mark style="color:orange;"><strong>w=400</strong></mark></a></p>                                                                                          |
| ![](https://content.gitbook.com/content/IDIcmPiz7q6Sr6ZHHQxV/blobs/9CBD42DGV7WxCguSDSpW/image.png) | <p>Trimmed image:<br><a href="https://doc.cloudimg.io/https://samples.scaleflex.com/sofa.jpg?w=400&#x26;trim=10">/samples.scaleflex.com/sofa.jpg?<mark style="color:orange;"><strong>w=400</strong></mark>&<mark style="color:orange;"><strong>trim=10</strong></mark></a></p>                  |