---
title: "resize_image. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/resize_image
description: "Make a resized copy of an image at an exact pixel size. Writes tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# resize_image

Make a resized copy of an image at an exact pixel size.

Writes [creative](https://metadata.io/developers/tools/#cat-creative)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `image_source` | string | required | URL of the image to resize: a public http(s) URL of a PNG, JPEG, WebP, GIF, BMP or TIFF image (an animation gives its first frame), such as an uploaded file, a library creative's URL, or a URL returned by an earlier creative tool. At most 25 MB and 25 megapixels; a larger JPEG is accepted when the t |
| `width` | integer |   | Target width in pixels. Omit it to scale proportionally from `height`. |
| `height` | integer |   | Target height in pixels. Omit it to scale proportionally from `width`. |
| `fit` | string |   | How to reach a target of another shape: pad, crop or stretch, as the tool description explains. Ignored when only one side is given.one of: `pad`, `crop`, `stretch` |
| `background` | string |   | What fills the bands `pad` adds: 'auto' (the image's own edges extended into the bands, row by row beside it or column by column above and below, so the seam shows no jump: a plain background continues as one flat color and a gradient as itself; transparent edges stay transparent), 'blur' (a blurred |
| `crop_focus` | string |   | The part of the image `crop` keeps. Ignored by pad and stretch.one of: `center`, `top`, `bottom`, `left`, `right` |
| `output_format` | string |   | 'auto' keeps a JPEG source as JPEG and writes PNG otherwise, switching to JPEG when an opaque PNG would pass 5 MB, the image limit of most ad channels. 'png' keeps transparency; 'jpeg' puts transparent areas on white.one of: `auto`, `png`, `jpeg` |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other creative tools:

- [archive_ad](https://metadata.io/developers/tools/archive_ad) Destructive
- [create_update_carousel_ad](https://metadata.io/developers/tools/create_update_carousel_ad) Destructive
- [create_update_convo_ad](https://metadata.io/developers/tools/create_update_convo_ad) Destructive
- [create_update_ctv_ad](https://metadata.io/developers/tools/create_update_ctv_ad) Destructive
- [create_update_document_ad](https://metadata.io/developers/tools/create_update_document_ad) Destructive
- [create_update_google_ads_ad](https://metadata.io/developers/tools/create_update_google_ads_ad) Destructive
- [create_update_image_ad](https://metadata.io/developers/tools/create_update_image_ad) Destructive
- [create_update_linkedin_message_ad](https://metadata.io/developers/tools/create_update_linkedin_message_ad) Destructive

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)