octobercms/october · error · ApplicationException

Missing configuration for [pivot.form] in RelationController

Error message

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

What it means

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

Source

Thrown at modules/backend/behaviors/relationcontroller/HasPivotMode.php:122

    }

    /**
     * onRelationManageAddPivot adds multiple items using a single pivot form.
     */
    public function onRelationManageAddPivot()
    {
        return $this->onRelationManagePivotForm();
    }

    /**
     * onRelationManagePivotForm
     */
    public function onRelationManagePivotForm()
    {
        $this->beforeAjax();

        if (!$this->pivotWidget) {
            throw new ApplicationException("Missing configuration for [pivot.form] in RelationController definition [{$this->field}].");
        }

        $this->vars['foreignId'] = $this->foreignId ?: post('checked');

        return $this->relationMakePartial('pivot_form');
    }

    /**
     * onRelationManagePivotCreate
     */
    public function onRelationManagePivotCreate()
    {
        $this->beforeAjax();

        // If the pivot model fails for some reason, abort the sync
        Db::transaction(function () {
            // Add the checked IDs to the pivot table
            $foreignIds = (array) $this->foreignId;

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/backend/behaviors/relationcontroller/HasPivotMode.php:122 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/2d713f809077bda4. Report an issue: GitHub.