Intervention/image · error · AnalyzerException

Failed to analyze unknown colorspace

Error message

Failed to analyze unknown colorspace

What it means

$image->colorspace() on the Imagick driver maps the native Imagick colorspace constant onto one of the library's colorspace classes. The match covers CMYK, sRGB/RGB, HSL, HSB and (on recent builds) OKLAB/OKLCH; every other colorspace — most commonly COLORSPACE_GRAY from grayscale JPEGs/PNGs, or LAB/XYZ/REC709 variants from TIFFs — falls into the default arm and throws AnalyzerException.

Source

Thrown at src/Drivers/Imagick/Analyzers/ColorspaceAnalyzer.php:44

    {
        try {
            $colorspace = $image->core()->native()->getImageColorspace();

            // OKLAB/OKLCH only exist on recent ImageMagick builds, so the
            // constants are resolved through defined()/constant() (mirroring the
            // ColorspaceModifier) to avoid referencing them where they are
            // undefined. Any unexpected resolution error is normalized below.
            return match (true) {
                $colorspace === Imagick::COLORSPACE_CMYK => new Cmyk(),
                $colorspace === Imagick::COLORSPACE_SRGB,
                $colorspace === Imagick::COLORSPACE_RGB => new Rgb(),
                $colorspace === Imagick::COLORSPACE_HSL => new Hsl(),
                $colorspace === Imagick::COLORSPACE_HSB => new Hsv(),
                defined(Imagick::class . '::COLORSPACE_OKLAB')
                    && $colorspace === constant(Imagick::class . '::COLORSPACE_OKLAB') => new Oklab(),
                defined(Imagick::class . '::COLORSPACE_OKLCH')
                    && $colorspace === constant(Imagick::class . '::COLORSPACE_OKLCH') => new Oklch(),
                default => throw new AnalyzerException('Failed to analyze unknown colorspace'),
            };
        } catch (Error $e) {
            throw new AnalyzerException('Failed to analyze colorspace', previous: $e);
        }
    }
}

View on GitHub (pinned to 5598b9e397)

Solutions

1. Normalize the colorspace before analysis: $image->setColorspace(\Intervention\Image\Colors\Rgb\Colorspace::class) so the analyzer always sees a supported value.
2. Wrap colorspace() in try/catch AnalyzerException and default to an sRGB assumption in your logic.
3. Convert grayscale/LAB sources to sRGB once at ingest if you control storage.

Example fix

// before
$colorspace = $image->colorspace(); // throws on grayscale images

// after: treat unreportable colorspaces as sRGB
try {
    $colorspace = $image->colorspace();
} catch (\Intervention\Image\Exceptions\AnalyzerException) {
    $colorspace = new \Intervention\Image\Colors\Rgb\Colorspace();
}

// peek at the native colorspace before calling colorspace()
$cs = $image->core()->native()->getImageColorspace();
$known = [Imagick::COLORSPACE_CMYK, Imagick::COLORSPACE_SRGB, Imagick::COLORSPACE_RGB, Imagick::COLORSPACE_HSL, Imagick::COLORSPACE_HSB];
if (!in_array($cs, $known, true)) {
    $image = $image->setColorspace(\Intervention\Image\Colors\Rgb\Colorspace::class);
}

try { $colorspace = $image->colorspace(); } catch (AnalyzerException) { $colorspace = new \Intervention\Image\Colors\Rgb\Colorspace(); }

When it happens

Trigger: Calling $image->colorspace() on a grayscale PNG/JPEG; LAB or exotic TIFFs from scanners and Adobe exports; images pre-processed by other ImageMagick commands so they report HSL/HSB; any analyzer that indirectly resolves the colorspace.

Common situations: Batch pipelines mixing camera JPEGs with scanned grayscale TIFFs; assets pushed through external ImageMagick steps before reaching the library.

Related errors

• Failed to convert image to sRGB
• Failed to analyze colorspace
• Failed to read image height
• Failed to read image width
• Colorspace

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