# Crop image

- Human page: https://happytails.ai/en/image-tools/crop-image/
- Markdown: https://happytails.ai/en/image-tools/crop-image.md
- Structured JSON: https://happytails.ai/agents/en/image-tools/crop-image/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `crop-image` |
| Category | image-tools |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Runs in your browser. Animated inputs produce a single still image. Supported decoding depends on your browser.

### Inputs and settings

No free-text input is required. Use the file inputs and/or settings below.

Accepted browser files: `image/*,.svg,.avif`. Choose one file.

| Setting | Meaning | Control type | Default | Constraints |
| --- | --- | --- | --- | --- |
| `width` | Width (px) | number | "" | min=1 max=16384 step=1 |
| `height` | Height (px) | number | "" | min=1 max=16384 step=1 |
| `x` | Left (px) | number | 0 | min=0 step=1 |
| `y` | Top (px) | number | 0 | min=0 step=1 |

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Visual crop, fixed aspect presets and pixel coordinates; export at intended resolution.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "crop-image",
  "category": "image-tools",
  "built": true,
  "requirements": "Visual crop, fixed aspect presets and pixel coordinates; export at intended resolution.",
  "implementation": {
    "fields": [
      {
        "key": "width",
        "label": "Width (px)",
        "value": "",
        "type": "number",
        "min": 1,
        "max": 16384,
        "step": 1
      },
      {
        "key": "height",
        "label": "Height (px)",
        "value": "",
        "type": "number",
        "min": 1,
        "max": 16384,
        "step": 1
      },
      {
        "key": "x",
        "label": "Left (px)",
        "value": 0,
        "type": "number",
        "min": 0,
        "step": 1
      },
      {
        "key": "y",
        "label": "Top (px)",
        "value": 0,
        "type": "number",
        "min": 0,
        "step": 1
      }
    ],
    "files": true,
    "accept": "image/*,.svg,.avif",
    "input": false,
    "note": "Runs in your browser. Animated inputs produce a single still image. Supported decoding depends on your browser.",
    "experience": {
      "automatic": false,
      "single": false,
      "label": "Your text",
      "placeholder": "Type or paste your input…",
      "help": "Up to 1,000,000 characters. Review the settings before running.",
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Crop a rectangular area from your image.

## How to use Crop image

1. Choose a file in an image format your browser can open.
2. Review the settings, then choose Run Crop image.
3. Review the result, then use Copy result or a download link when available.

## What to expect

Crop a rectangular area from your image. Set the top-left position and the width and height in pixels. The original file stays on your device.

## Useful next steps

- [Aspect ratio calculator](https://happytails.ai/en/design-tools/aspect-ratio-calculator/): Find the simplest aspect ratio from a width and height. ([Markdown](https://happytails.ai/en/design-tools/aspect-ratio-calculator.md))

- [DPI calculator](https://happytails.ai/en/maker-tools/dpi-calculator/): Calculate pixel density from pixel count and physical size. ([Markdown](https://happytails.ai/en/maker-tools/dpi-calculator.md))

- [Resize image](https://happytails.ai/en/image-tools/resize-image/): Resize an image to the dimensions you need. ([Markdown](https://happytails.ai/en/image-tools/resize-image.md))