octobercms/october · error · ApplicationException

The provided model class ":modelClass" for the recordfinder

Error message

The provided model class ":modelClass" for the recordfinder is invalid

What it means

Error "The provided model class ":modelClass" for the recordfinder is invalid" thrown in octobercms/october.

Source

Thrown at modules/backend/formwidgets/RecordFinder.php:189

            'defaultSort',
            'showSetup',
            'structure',
            'conditions',
            'inlineOptions',
            'searchMode',
            'searchScope',
            'recordsPerPage',
            'useRelation',
            'modelClass',
            'popupSize',
        ]);

        if (isset($this->config->scope)) {
            $this->modelScope = $this->config->scope;
        }

        if (!$this->useRelation && !class_exists($this->modelClass)) {
            throw new ApplicationException(Lang::get('backend::lang.recordfinder.invalid_model_class', ['modelClass' => $this->modelClass]));
        }

        if (!post('recordfinder_flag')) {
            return;
        }

        $this->listWidget = $this->makeListWidget();
        $this->listWidget->bindToController();

        // Search widget
        if ($this->searchWidget = $this->makeSearchWidget()) {
            $this->listWidget->setSearchTerm($this->searchWidget->getActiveTerm());

            // Link the Search Widget to the List Widget
            $this->searchWidget->bindEvent('search.submit', function () {
                $this->listWidget->setSearchTerm($this->searchWidget->getActiveTerm());
                return $this->listWidget->onRefresh();
            });

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/backend/formwidgets/RecordFinder.php:189 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/3c069cb810ad2795. Report an issue: GitHub.