---
title: trim
summary: null
url: https://www.fastly.com/documentation/reference/io/trim
---

Remove pixels from the edge of an image.

The `trim` parameter removes pixels from the edge of an image by pixel or percentage value. This can be useful for removing whitespace and borders that appear on a source image.

## Syntax

```text
trim={top},{right},{bottom},{left}
```

## Sub-parameters

| Param    | Units                | Description                                      |
| -------- | -------------------- | ------------------------------------------------ |
| `top`    | Pixels or Percentage | Amount to trim from the top of the image.        |
| `right`  | Pixels or Percentage | Amount to trim from the right side of the image. |
| `bottom` | Pixels or Percentage | Amount to trim from the bottom of the image.     |
| `left`   | Pixels or Percentage | Amount to trim from the left side of the image.  |

## Notes

1. Values can be specified using CSS style shorthand values. (See [CSS Margin](https://developer.mozilla.org/en-US/docs/Web/CSS/margin) or [CSS Padding](https://developer.mozilla.org/en-US/docs/Web/CSS/padding) for more examples).
2. CSS shorthand allows for all edges to be specified in one property.
3. Any fractional pixel measurements will be rounded to the nearest whole pixel.

## Examples

Click the links to view the transformed image using a demo Fastly IO service.

| Example usage                                                             | Description                                                               |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [`?trim=25,50,75,100`](https://www.fastly.io/image.jpg?trim=25,50,75,100) | Trim top edge 25px, right edge 50px, bottom edge 75px and left edge 100px |
| [`?trim=25,50,75`](https://www.fastly.io/image.jpg?trim=25,50,75)         | Trim top edge 25px, right and left edge 50px, bottom edge 75px            |
| [`?trim=25,50`](https://www.fastly.io/image.jpg?trim=25,50)               | Trim top and bottom edge 25px, right and left edge 50px                   |
| [`?trim=0.25`](https://www.fastly.io/image.jpg?trim=0.25)                 | Trim all edges by 25%                                                     |