Data Migration

Already have a roster? Bring it with you.

The fastest way to onboard your agency. Drop in a CSV from your old spreadsheet — or whatever you're leaving behind — and Muster figures out the rest. Members, custom fields, and the files attached to each one.

Where to find it

01Step 01Bring your roster

Drop in a CSV and the documents that go with it.

Export from a spreadsheet, your old scheduling tool, or whatever you have today. Muster reads the headers, counts the rows, and gets you ready to map. Optional: drag in the PDFs and photos that go with the roster — cert cards, licenses, headshots — and Muster will match them to members in the next step.

1Upload
2
3
members-2026.csvReady

247 rows · 12 columns detected

First NameLast NameEmailPositionsPhone+ 7 more

Attached documents

5 files · optional
morgan-ellis-cpr.pngimage
caleb-rivera-certification.pdfpdf
priya-shah-license.pdfpdf
morgan-headshot.jpgimage
caleb-rivera-cpr.pdfpdf

We'll suggest column mappings on the next step.

02Step 02Auto-mapped columns

Your columns, already mapped.

Muster suggests mappings for every column the moment you upload. Built-in fields like name, email, and positions are matched first. Then any of your existing custom fields with a matching name get filled in too. Anything left over becomes a new custom field with the right type picked for you. Adjust whatever you want, ignore the rest.

2Map columns
3
Auto-mapped on upload· 1 matched to an existing field, 3 new fields will be created
First Name
Morgan
First nameBuilt-in
Last Name
Ellis
Last nameBuilt-in
Email
morgan.ellis@…
EmailBuilt-in
Positions
Driver, Event Lead
PositionsBuilt-in
Phone
555-210-1001
Phonephone
Start Date
2026-05-01
Start dateYour field
CPR Card
morgan-ellis-cpr.png
CPR cardfile
Background Check File
morgan-ellis-bgcheck.pdf
Background checkfile
Notes
Prefers weekday evenings.
Skip column
Built-in
Your existing field
New custom field
Skipped
03Step 03 — Review & import

See exactly what will happen before you commit.

Before any data is saved, Muster previews every member, surfaces warnings for unfamiliar positions or out-of-range values, and blocks the import on hard errors like duplicate emails. When you confirm, the entire import runs as one transaction — all in, or nothing changes.

3Review & import
Members ready
247
Warnings
3
Errors
0
PreviewShowing 3 of 247
ME
Morgan Ellis
morgan.ellis@example.com·555-210-1001
DriverEvent Lead
PS
Priya Shah
priya.shah@example.com·555-210-1002
Kitchen
CR
Caleb Riveranew position
caleb.rivera@example.com·555-210-1003
SetupDriver
247 members, 4 new fields, 4 files— atomic import

Admin guide

Preparing your CSV.

Five minutes of cleanup makes the import go smoothly. Here's exactly what Muster expects, written so you can hand it off to whoever owns the spreadsheet.

A.

What's required, what's optional

Required
  • First name and last name. Map them as separate columns, or map a single Full Name column and Muster will split it for you.
  • Unique emails — if you map an email column. Each email must be unique within the CSV and not already exist in your organization.
Optional

Everything else: phone numbers, positions, start dates, cert expirations, checkboxes, URLs, attached files, and any other custom fields you want to track. Muster matches columns to your existing custom fields by name, and creates new ones on the fly for anything it doesn't recognize.

B.

Value formats

Each column has a type. Here's what Muster expects in the cell.

Date
ISO format: YYYY-MM-DD
2027-04-15
Phone
At least 10 digits — dashes and parens are fine
555-210-1001
Email
Standard email format, must be unique
member@example.com
Number
Digits or decimals
4.5
Checkbox
yes/no or true/false
yes
URL
Full URL with protocol
https://example.com
C.

Positions and attached files

These two are worth a closer look — they trip people up most often.

Positions

Put multiple positions in a single cell, separated by a ,, ;, or |. Positions must already exist in your org.

Example cell

Driver, Event Lead

Unknown positions show as warnings — the member is still imported, but that position is skipped for them.

Attached files

Set the column type to file. The cell must contain the exact filename — including extension — of a file you drag into the uploader. No folder paths.

CSV cell

morgan-ellis-cpr.png

Uploaded file

morgan-ellis-cpr.png
D.

Start with the template

A working CSV with the most common columns. Open it, paste your roster in, and tweak.

sample-member-import.csv
Download template
First NameLast NameEmailPositionsPhoneStart DateCPR CardBackground Check FileNotes
MorganEllismorgan.ellis@example.comDriver, Event Lead555-210-10012026-05-01morgan-ellis-cpr.pngmorgan-ellis-bgcheck.pdfPrefers weekday evenings.
PriyaShahpriya.shah@example.comKitchen555-210-10022026-05-03New transfer from another platform.
CalebRiveracaleb.rivera@example.comSetup | Driver555-210-10032026-05-10caleb-rivera-cpr.pdfcaleb-rivera-certification.pdfHas completed orientation.
Column names don't have to match this exactly — Muster will suggest a mapping for whatever you upload. The template is just a known-good starting point.
E.

What imports will and won't do

Predictable behavior, no surprises.

Creates only

The importer never updates or deletes existing members. Safe to run partial imports — existing data is untouched.

Atomic transactions

Either every row imports successfully, or nothing changes. No half-finished imports to clean up.

Billing limits enforced

If the import would push you past your plan's member limit, the whole thing is blocked before anything is created.

Ready to stop overpaying?

Completely free to start. No credit card needed, no sales call required.