octobercms/october · error · ApplicationException

Please match some columns first.

Error message

Please match some columns first.

What it means

Error "Please match some columns first." thrown in octobercms/october.

Source

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

    }

    /**
     * importIsColumnRequired
     */
    public function importIsColumnRequired($columnName)
    {
        $model = $this->importGetModel();

        return $model->isAttributeRequired($columnName);
    }

    /**
     * checkRequiredImportColumns
     */
    protected function checkRequiredImportColumns()
    {
        if (!$matches = post('column_match', [])) {
            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.", [

View on GitHub (pinned to b608633a7e)

When it happens

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