Skip to main content

Preparing your data before importing

How to format and clean up your files — file types, required columns, date and amount formats — so Gracely's import wizards run cleanly.

A little prep before you import makes everything smoother. This guide covers how to format your files so Gracely's Import people and Import gifts wizards run cleanly.

File format

  • Save your files as CSV or Excel (.xlsx). These are the only formats the import wizards accept.

  • Put your column headers in the first row, with one record per row after that.

  • Remove blank rows at the top and any totals/summary rows at the bottom — Gracely reads every data row as a record.

Required columns

For people:

  • At least one name field: Full Name, or First Name / Last Name / Middle Name.

  • Email is highly recommended — it lets members log in and lets Gracely link future giving to the right person.

For giving:

  • Amount (required)

  • Date (required)

  • Donor Name or Email (at least one, so gifts can be matched to people)

  • Optional but useful: Fund Name, Payment Method, Check Number / Note, Batch Date, Tax Deductible, Frequency

💡 Tip: Import your people first, then your giving. Gracely matches each gift to a member by name first, then email — so having members in place means more gifts get linked automatically.

Dates and amounts

  • Use a clear date format such as MM/DD/YYYY (for example, 01/15/2024). Rows with a date Gracely can't read are skipped and listed in the import summary.

  • Amounts should be plain numbers (for example, 100.00). Currency symbols are fine, but avoid mixing text into the amount column. Rows with an unreadable amount are skipped.

Clean up before importing

  • Remove duplicates — repeated rows become repeated records.

  • Standardize names — consistent spelling helps donor matching (for example, always "Bob Smith," not sometimes "Robert Smith").

  • Split or combine name columns to match how you'll map them (one Full Name column, or separate First/Last).

  • One fund per giving row — Gracely reads a single fund name per gift. If your old system exported split gifts on one line, separate them into individual rows.

  • Trim extra columns you don't need — you can also just leave them unchecked during mapping.

Large files

  • If an export is very large or times out, split it into smaller files (for example, one year of giving at a time) and import them one after another.

Final check

Open your file and scan a few rows:

  • Do the columns line up with their headers?

  • Are dates and amounts formatted consistently?

  • Is there a name (and ideally an email) on every row?

Still need help? Start a chat with us, or email [email protected].

Did this answer your question?