# Merge images

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

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `merge-images` |
| 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 |

### Inputs and settings

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

Accepted browser files: `image/*,.svg,.avif`. Multiple files are supported.

| Setting | Meaning | Control type | Default | Constraints |
| --- | --- | --- | --- | --- |
| `direction` | Arrange | select | "Horizontal" | Allowed: Horizontal, Vertical |
| `background` | 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

Horizontal/vertical layout, spacing, background and equal-size options.

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

### Complete machine-readable capability record

```json
{
  "id": "merge-images",
  "category": "image-tools",
  "built": true,
  "requirements": "Horizontal/vertical layout, spacing, background and equal-size options.",
  "implementation": {
    "fields": [
      {
        "key": "direction",
        "label": "Arrange",
        "value": "Horizontal",
        "type": "select",
        "values": [
          "Horizontal",
          "Vertical"
        ]
      },
      {
        "key": "background",
        "label": "Background",
        "value": "#ffffff",
        "type": "color"
      }
    ],
    "files": true,
    "multiple": true,
    "input": false,
    "accept": "image/*,.svg,.avif",
    "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

Combine multiple images into one image.

## Useful next steps

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

- [AVIF to PNG](https://happytails.ai/en/image-tools/avif-to-png/): Convert a AVIF image to PNG in your browser. ([Markdown](https://happytails.ai/en/image-tools/avif-to-png.md))

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

## How to use Merge images

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

## What to expect

Combine multiple images into one image. Add your images, arrange their order, and choose the available layout settings before combining them.