> ## Documentation Index
> Fetch the complete documentation index at: https://docs.port.church/llms.txt
> Use this file to discover all available pages before exploring further.

# Notes Import: Resolving Errors

> How notes import errors are surfaced and how to fix them

Notes errors are either upload-time validation errors or import-time unresolved rows.

## Upload-Time Errors (Fix CSV and Re-upload)

Common upload-blocking issues:

* Missing required headers (`Note Category`, `First Name`, `Last Name`, `Note`)
* Missing category value on one or more rows
* Invalid category name (category not found in Planning Center)
* Invalid `Remote ID` format
* Invalid `Created At` or `Updated At` date format

## Import-Time Errors (Resolve on Import Screen)

Rows can still become `unresolved` during processing, usually because:

* No person match found
* Planning Center API validation errors while creating the note

## Resolution Actions in Port

For unresolved rows you can:

* Search and assign an existing Planning Center person
* Create a person from the row
* Save and requeue the row

## Tips

* Keep note category names exactly aligned with Planning Center.
* Include `Remote ID`, `Email`, and `Phone Number` to reduce person-match failures.
* If upload validation fails, fix the file and upload again (those issues are not fixed on the Import screen).