Importing Accessions
Bring a spreadsheet of accessions into your archive — useful when you're migrating from a legacy system or you have a backlog of metadata-only records waiting for digitised files.
Bringing a register in needs an archivist seat — reviewers and volunteers aren't offered the page.
Supported formats
The import wizard accepts spreadsheets in these formats:
| Format | File extension |
|---|---|
| CSV (comma-separated) | .csv |
| Tab-delimited | .tsv, .txt |
| Excel | .xlsx |
Tab-delimited files (the default output from many archival management systems) are detected automatically. The wizard shows you which format was recognised and lets you correct it if needed.
Required and optional columns
Your spreadsheet must include:
| Field | Required | What it is |
|---|---|---|
| Accession number | ✓ | Your institutional accession identifier (e.g. "2026/001", "ACC-042") |
| Name / Title | ✓ | A brief name or description for the accession |
| Depositor | Person or organisation that donated / deposited the material | |
| Depositor email | Email address — used to match or create a depositor record in the system | |
| Date received | ISO date (YYYY-MM-DD) or just the year (YYYY) | |
| Description | Longer narrative description of the accession's contents | |
| Notes | Internal notes (e.g. "requires conservation before digitisation") |
Column names are case-insensitive and flexible — common aliases like "AccNo", "Source", "Email" are detected automatically.
Step-by-step import
An accessions import walks six named steps — Choose · Upload · Map · Preview · Bring in · Done. (A catalogue-records import walks a seventh, Check, which a flat register of accessions has nothing to answer.)
Choose
Open Import in the sidebar, or Import register above the table on the Register tab of Accessions, and pick Accessions as what you're bringing in.
Upload
- Drag your file onto the upload area or click Browse files.
- The wizard detects the format and shows a preview: column names, detected delimiter and character encoding, row count — each of which you can correct.
- The published file-size, row-count and page-count limits are printed under the file input.
Map
The wizard shows three buckets:
- Mapped columns (on the right) — fields the system recognised. You can edit the mapping if the auto-detection missed it.
- Unmapped columns (on the left) — columns the system didn't recognise. Click Ignore to skip them, or Map to assign them to a canonical field.
- Unfilled required fields (at the bottom) — "Accession number" or "Name" still unmapped. You must assign these before proceeding.
Once the mapping is correct, you can optionally save this mapping as a profile (name and store it) to reuse on the next file from the same source system.
Preview
The preview shows:
- Row count — how many accessions will be imported
- Collisions — accession numbers already in your system (existing records) or duplicated within the file
- Depositor summary — how many depositors will be matched to existing records, created new, or flagged for review
- Sample rows — a preview of the first few records
If there are accession number collisions, choose a collision policy:
- Skip — don't import rows with numbers that already exist; keep the existing records untouched
- Suffix — import the row anyway, but rename it to
<number> (import)to avoid the collision
Bring in, and Done
Review the collision policy and any warnings, then Bring in — the verb the wizard uses throughout. Large files run server-side and survive a closed tab. The Done screen names any sheets left out, offers a row-by-row reconciliation report against the source file, and the import can be undone in one action if it went wrong.
The accessions are created as draft records with no files attached. They're now ready for you to add digitised files to them.
What gets imported
Each row becomes a new accession record with:
- Accession number — from your spreadsheet, checked for collisions
- Name — the title field from your data
- Description — the description field, if present
- Date received — parsed flexibly (year-only, UK DD/MM/YYYY, ISO formats all work)
- Depositor — matched or created based on:
- Legacy reference (if your data has a
depositor_id-style field) - Email address exact match (case-insensitive)
- Name exact match after normalisation (trimmed, collapsed whitespace)
- Create new (if no match found)
- Legacy reference (if your data has a
- Notes — stored as internal provenance notes
What does NOT get imported
Imported accessions are draft records with no files. They appear on your Accessions list with status Draft and file count 0 files. You can then:
- Add files to them when the digitised originals are available
- Edit their metadata directly (click the title to rename, expand fields to edit)
- Assign them to a fond in your archival hierarchy
Common questions
Can I import accessions without an accession number? No — accession number is required. If your data has some rows without numbers, they'll be flagged as skipped during the preview, and you can edit your spreadsheet to add placeholder numbers or omit those rows.
What if my dates are in a format the wizard doesn't recognise?
The wizard tries to parse year-only (YYYY), ISO (YYYY-MM-DD), and UK (DD/MM/YYYY) formats. If a date doesn't parse, it's stored as null and you can edit it in the accession afterwards. The preview shows which dates failed to parse.
Can I re-use the same mapping file for a second import? Yes — after the first import, the wizard shows saved mapping profiles in the Map step, and the import page lets you rename, delete or look back at earlier versions of one. Pick your profile from the dropdown and it pre-fills all your column assignments, then proceed. You can update a profile to a new version if your source system's columns change slightly.
What happens if I import the same accession number twice by accident? The collision policy prevents it. Choose Skip to keep your existing record, or Suffix to import both (the second gets renamed with "(import)"). Either way, you won't have duplicates.
How do I import with a custom set of fields? Custom fields are not imported automatically — only the standard accession fields listed above. After import, you can add files and fill custom fields in the wizard or edit the accession directly.
See also
- Creating an accession — for new single accessions
- Creating and linking depositors — how the same match-or-create logic works when linking depositors by hand
- Importing a structure — to import your archival hierarchy first
- Uploading files — to add digitised files to your accessions