# Region

The region to use when cropping the image.

Set this parameter only when you want to specify a fixed region. If you do not set this parameter, Media Server uses the region data in the input record (for example a bounding box around a detected face or object).

Specify the region as a comma-separated list of values in the order: `left,top,width,height`, followed by the units that you want to use.

- `left` is the distance from the left of the frame to the left edge of the region.
- `top` is the distance from the top of the frame to the top edge of the region.
- `width` is the width of the region.
- `height` is the height of the region.

You can choose the following units:

- `percent` or `%` to use percentages of the image or video dimensions (`left` and `width` as percentages of the width, `top` and `height` as percentages of the height).
- `pixels` or `px` to use numbers of pixels.

Type: | Custom
Default: | Region data from the input record
Required: | No
Configuration Section: | TaskName
Example: | The following example crops the image, keeping the central 25% of the image.
    Region=25,25,50,50 percent
See Also: |

_FT_HTML5_bannerTitle.htm