# The imports manual

<!-- module: s15-imports · deck: Add many people at once from a spreadsheet: the file is scanned, each column matched, every row checked as Add a person checks it, nothing saved until you say so; the import runs in the background, offers the invitations, and can be undone for a day, except what someone has changed since. -->

**Table of contents · 25 October 2026 · S15 of plan CORE. One import engine; people is the first kind a product
imports, and a product adds its own.**

When you have more than a handful of people to add, bring them in from a spreadsheet (CSV or Excel). The file goes
through the file vault (scanned for malware, encrypted). You say which column is which, and **every row is checked
first**, as **Add a person** would check it: nobody is added twice, a row the form would refuse is refused, and you
see why for each one. Nothing is saved until you choose. The import then runs in the background; the bell tells you
when it's done. For a day afterwards it can be undone, except what someone has changed since.

The one sentence to carry through it: **the check writes nothing, the import goes through the same doors as the form,
and undo leaves what someone else touched.**

**Who meets what**

| Seat | Who | What they do here |
|---|---|---|
| Admin | Anyone whose role holds *Import people from a spreadsheet* (the Owner, and the Admin as shipped) | Imports; opens any import's report; undoes one |
| Person who ran it | The importer | Chooses its columns, runs it, discards it; downloads its file; is told when it's done |
| Member | Anyone else | Nothing: Import isn't shown |

**As shipped**

| | Shipped |
|---|---|
| Files | CSV or Excel (.xlsx), one sheet at a time, up to 5,000 rows |
| An import can be undone for | 24 hours (a workspace may change it, 1 to 168 hours) |
| Its file and its rows are kept | 30 days, then the night's purge clears them; the import's line stays |
| One person may have | one unfinished import at a time |
| Dates are written | guessed from the file (day/month/year unless it's clearly month first) |

---

## Part 1 · Imports

- [1.1 Importing people from a spreadsheet](p01-imports.md#11-importing-people-from-a-spreadsheet)
- [1.2 Fixing the rows the check found](p01-imports.md#12-fixing-the-rows-the-check-found)
- [1.3 After the import: the report and the invitations](p01-imports.md#13-after-the-import-the-report-and-the-invitations)
- [1.4 Undoing an import](p01-imports.md#14-undoing-an-import)
- [1.5 Earlier imports, and discarding one](p01-imports.md#15-earlier-imports-and-discarding-one)
