livewire/livewire · error · ComponentNotFoundException

Unable to find component: [{$name}]

Error message

Unable to find component: [{$name}]

What it means

Error "Unable to find component: [{$name}]" thrown in livewire/livewire.

Source

Thrown at src/Factory/Factory.php:76

                if ($path) {
                    $class = $this->compiler->compile($path);
                }
            }
        }

        if (! $class || ! class_exists($class) || ! is_subclass_of($class, Component::class)) {
            foreach ($this->missingComponentResolvers as $resolver) {
                if ($class = $resolver($name)) {
                    $this->finder->addComponent(name: $name, class: $class);

                    break;
                }
            }
        }

        if (! $class || ! class_exists($class) || ! is_subclass_of($class, Component::class)) {
            throw new ComponentNotFoundException(
                "Unable to find component: [{$name}]"
            );
        }

        $this->resolvedComponentCache[$name] = $class;

        return [$name, $class];
    }

    public function resolveComponentClass($name): string
    {
        [$name, $class] = $this->resolveComponentNameAndClass($name);

        return $class;
    }

    public function resolveComponentName($name): string
    {

View on GitHub (pinned to 1a3fde34c5)

When it happens

Trigger: Thrown at src/Factory/Factory.php:76 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of livewire/livewire@1a3fde34c5 (2026-08-17). Data as JSON: /api/errors/e18414860f88d1f2. Report an issue: GitHub.