1. Home
2. Reference documentation
3. Image Optimizer

Add pixels to the edge of an image.

Syntax

pad={all-sides}
pad={top-and-bottom},{left-and-right}
pad={top},{left-and-right},{bottom}
pad={top},{right},{bottom},{left}

Sub-parameters

Notes

1. By default padding applies a background color of white. See bg-color to change that.
2. If the source image contains a transparent background and the output image also contains transparency, the padding will be made up of transparent pixels.
3. When using pad and canvas at the same time, pad will be ignored.
4. Values can be specified using CSS style shorthand values. (see CSS Margin or CSS Padding for more examples).
5. CSS shorthand allows for all edges to be specified in one property.
6. 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.