octobercms/october · error · SystemException

Class name is not registered for the component "%s". Check t

Error message

Class name is not registered for the component "%s". Check the component plugin.

What it means

Error "Class name is not registered for the component "%s". Check the component plugin." thrown in octobercms/october.

Source

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

        }

        return isset($this->classMap[$className]);
    }

    /**
     * makeComponent object with properties set.
     * @param string $name A component class name or code.
     * @param CmsObject $cmsObject The Cms object that spawned this component.
     * @param array $properties The properties set by the Page or Layout.
     * @return ComponentBase|null The component object.
     */
    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,

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/cms/classes/ComponentManager.php:292 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/57b51edadcd5f03c. Report an issue: GitHub.