Intervention/image · error · Intervention\Image\Exceptions\NotSupportedException

Unprocessable input

Error message

Unprocessable input

What it means

Error "Unprocessable input" thrown in Intervention/image.

Source

Thrown at src/InputHandler.php:120

        }

        if ($input === '') {
            throw new InvalidArgumentException('Unable to decode from empty string');
        }

        // if handler has only one single decoder run it can run directly
        if (count($this->decoders) === 1) {
            return $this->decoders()->current()->decode($input);
        }

        // multiple decoders: try to find the matching decoder for the input
        foreach ($this->decoders() as $decoder) {
            if ($decoder->supports($input)) {
                return $decoder->decode($input);
            }
        }

        throw new NotSupportedException('Unprocessable input');
    }

    /**
     * Yield all decoders.
     *
     * @throws InvalidArgumentException
     * @throws DriverException
     */
    private function decoders(): Generator
    {
        foreach ($this->decoders as $decoder) {
            yield $this->decoder($decoder);
        }
    }

    /**
     * Resolve the given classname or object to a decoder object.
     *

View on GitHub (pinned to 5598b9e397)

Solutions

1. Pass input the handler can process: binary image string, data URI, base64 string, file path, SplFileInfo, stream, or ImageInterface
2. Enable the matching decoder for the driver (e.g. FilePathImageDecoder, BinaryImageDecoder) or install imagemagick/gd support for the format
3. Inspect InputHandler::handle()'s supported types and convert your input to one of them

When it happens

Trigger: Thrown at src/InputHandler.php:120 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Intervention/image@5598b9e397 (2026-08-23). Data as JSON: /api/errors/e3ca4d571ce02fee. Report an issue: GitHub.