octobercms/october · error · SystemException

The model class :model must define a method :method() return

Error message

The model class :model must define a method :method() returning options for the ':filter' filter.

What it means

Error "The model class :model must define a method :method() returning options for the ':filter' filter." thrown in octobercms/october.

Source

Thrown at modules/backend/classes/FilterScope.php:68

        if (
            strpos($methodName, '::') !== false &&
            ($staticMethod = explode('::', $methodName)) &&
            count($staticMethod) === 2 &&
            is_callable($staticMethod)
        ) {
            $scopeOptions = $staticMethod($model, $this);

            if (!is_array($scopeOptions)) {
                throw new SystemException(Lang::get('backend::lang.field.options_static_method_invalid_value', [
                    'class' => $staticMethod[0],
                    'method' => $staticMethod[1]
                ]));
            }
        }
        // Calling via $model->method
        else {
            if (!$this->objectMethodExists($model, $methodName)) {
                throw new SystemException(Lang::get('backend::lang.filter.options_method_not_exists', [
                    'model' => get_class($model),
                    'method' => $methodName,
                    'filter' => $this->fieldName
                ]));
            }

            $scopeOptions = $model->$methodName($this);
        }

        return $scopeOptions;
    }

    /**
     * applyScopeMethodToQuery
     */
    public function applyScopeMethodToQuery($query, $methodName = null)
    {
        if (!$methodName) {

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/backend/classes/FilterScope.php:68 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/a66778c42a6db9f2. Report an issue: GitHub.