octobercms/october · error · SystemException

Field {$name} was not found in the form definitions.

Error message

Field {$name} was not found in the form definitions.

What it means

Error "Field {$name} was not found in the form definitions." thrown in octobercms/october.

Source

Thrown at modules/backend/behaviors/formcontroller/HasRenderers.php:34

     * @param array $options (e.g. ['useContainer'=>false])
     * @return string HTML markup
     */
    public function formRenderField($name, $options = [])
    {
        return $this->formWidget->renderField($name, $options);
    }

    /**
     * formRefreshField is a view helper to render a field from AJAX based on their field names.
     * @param array|string $names
     */
    public function formRefreshFields($names): array
    {
        $result = [];

        foreach ((array) $names as $name) {
            if (!$fieldObject = $this->formWidget->getField($name)) {
                throw new SystemException("Field {$name} was not found in the form definitions.");
            }

            $result['#' . $fieldObject->getId('group')] = $this->formRenderField($name, ['useContainer' => false]);
        }

        return $result;
    }

    /**
     * formRenderPreview is a view helper to render the form in preview mode.
     *
     *     <?= $this->formRenderPreview() ?>
     *
     * @return string The form HTML markup.
     */
    public function formRenderPreview()
    {
        return $this->formWidget->render(['preview' => true]);

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/backend/behaviors/formcontroller/HasRenderers.php:34 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/3b917f3b8c24563e. Report an issue: GitHub.