octobercms/october · error · ApplicationException

Please specify a match for the required field :label.

Error message

Please specify a match for the required field :label.

What it means

Error "Please specify a match for the required field :label." thrown in octobercms/october.

Source

Thrown at modules/backend/behaviors/importexportcontroller/ActionImport.php:265

            throw new ApplicationException(__("Please match some columns first."));
        }

        $dbColumns = $this->getImportDbColumns();
        foreach ($dbColumns as $column => $label) {
            if (!$this->importIsColumnRequired($column)) {
                continue;
            }

            $found = false;
            foreach ($matches as $matchedColumns) {
                if (in_array($column, $matchedColumns)) {
                    $found = true;
                    break;
                }
            }

            if (!$found) {
                throw new ApplicationException(__("Please specify a match for the required field :label.", [
                    'label' => __($label)
                ]));
            }
        }
    }
}

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/backend/behaviors/importexportcontroller/ActionImport.php:265 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/d740648bbf864bb1. Report an issue: GitHub.