octobercms/october · error · ApplicationException

Missing configuration for [manage.{$this->manageMode}] in Re

Error message

Missing configuration for [manage.{$this->manageMode}] in RelationController definition [{$this->field}].

What it means

Error "Missing configuration for [manage.{$this->manageMode}] in RelationController definition [{$this->field}]." thrown in octobercms/october.

Source

Thrown at modules/backend/behaviors/relationcontroller/HasManageMode.php:241

        $config->parentFieldName = $this->field;

        $widget = $this->makeWidget(FormWidget::class, $config);

        return $widget;
    }

    /**
     * onRelationManageForm
     */
    public function onRelationManageForm()
    {
        // The form should not share its session key with the parent
        $this->bumpSessionKeys = true;

        $this->beforeAjax();

        if ($this->manageMode === 'form' && !$this->manageFormWidget) {
            throw new ApplicationException("Missing configuration for [manage.{$this->manageMode}] in RelationController definition [{$this->field}].");
        }

        if ($this->manageMode !== 'form' && !$this->manageListWidget) {
            throw new ApplicationException("Missing configuration for [manage.{$this->manageMode}] in RelationController definition [{$this->field}].");
        }

        // Updating an existing record
        if ($this->manageMode === 'pivot' && ($this->manageId || $this->pivotId)) {
            return $this->onRelationManagePivotForm();
        }

        $this->vars['newSessionKey'] = $this->sessionKey;

        return $this->relationMakePartial('manage_' . $this->manageMode);
    }

    /**
     * onRelationManageCreate a new related model

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/backend/behaviors/relationcontroller/HasManageMode.php:241 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/8be0f5ba351cb349. Report an issue: GitHub.