> ## 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.

# Groups Import: Resolving Errors

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

Groups errors appear in two places: upload-time validation and import-time unresolved rows.

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

These stop the upload step:

* Missing required headers (`Group Name`, `Role`, `First Name`, `Last Name`)
* Invalid `Role` value (must resolve to `leader` or `member`)
* Invalid `Group Name` (group does not exist in Planning Center)
* Invalid `Remote ID` format (must parse as unsigned integer)
* Invalid `Joined At` date format

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

These are rows that reach processing but are marked `unresolved`:

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

## 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 for processing

## Tips

* Include `Remote ID`, `Email`, and `Phone Number` when possible.
* Validate group names in Planning Center before uploading.
* Keep role values consistent (`member` or `leader` semantics).