# Compress image

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

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `compress-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 |
| --- | --- | --- | --- | --- |
| `quality` | Quality (%) | number | 85 | min=1 max=100 step=1 |
| `format` | Output format | select | "WebP" | Allowed: WebP, JPEG |
| `background` | JPEG background | color | "#ffffff" |  |

### 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

Show before/after bytes and preview; preserve original download; never guarantee all files shrink.

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

### Complete machine-readable capability record

```json
{
  "id": "compress-image",
  "category": "image-tools",
  "built": true,
  "requirements": "Show before/after bytes and preview; preserve original download; never guarantee all files shrink.",
  "implementation": {
    "fields": [
      {
        "key": "quality",
        "label": "Quality (%)",
        "value": 85,
        "type": "number",
        "min": 1,
        "max": 100,
        "step": 1
      },
      {
        "key": "format",
        "label": "Output format",
        "value": "WebP",
        "type": "select",
        "values": [
          "WebP",
          "JPEG"
        ]
      },
      {
        "key": "background",
        "label": "JPEG background",
        "value": "#ffffff",
        "type": "color"
      }
    ],
    "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": "Compress image"
    },
    "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

Reduce an image’s file size with adjustable quality and format.

## Useful next steps

- [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))

- [Compress image to 100kb](https://happytails.ai/en/image-tools/compress-image-to-100kb/): Create a smaller image with a target size of 100 KB. ([Markdown](https://happytails.ai/en/image-tools/compress-image-to-100kb.md))

- [JPG to WEBP](https://happytails.ai/en/image-tools/jpg-to-webp/): Convert a JPG image to WEBP in your browser. ([Markdown](https://happytails.ai/en/image-tools/jpg-to-webp.md))

## How to use Compress image

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

## What to expect

Reduce an image’s file size with adjustable quality and format. Choose WebP or JPEG, compare the result with your original, and download the version that works for you. Small, already optimized files may become larger.