octobercms/october · error · SystemException

Component class not found "%s". Check the component plugin.

Error message

Component class not found "%s". Check the component plugin.

What it means

Error "Component class not found "%s". Check the component plugin." thrown in octobercms/october.

Source

Thrown at modules/cms/classes/ComponentManager.php:303

     */
    public function makeComponent($name, $cmsObject = null, $properties = [])
    {
        $className = $this->resolve($name);
        if (!$className) {
            $strictMode = Config::get('cms.strict_components', false);
            if ($strictMode) {
                throw new SystemException(sprintf(
                    'Class name is not registered for the component "%s". Check the component plugin.',
                    $name
                ));
            }
            else {
                return null;
            }
        }

        if (!class_exists($className)) {
            throw new SystemException(sprintf(
                'Component class not found "%s". Check the component plugin.',
                $className
            ));
        }

        $component = App::make($className, [
            'cmsObject' => $cmsObject,
            'properties' => $properties
        ]);

        $component->name = $name;

        return $component;
    }

    /**
     * findComponentOwnerDetails returns details about the component owner as an array.
     */

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/cms/classes/ComponentManager.php:303 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of octobercms/october@b608633a7e (2026-08-21). Data as JSON: /api/errors/b3383334ac0fe31f. Report an issue: GitHub.