Sign in
Choose your match type
Both options produce a verifiably fair, stable result. The right one depends on the rules of your intake. You can change your choice at any time using the "Change" link at the top of the next page.
Match type: Standard
Nothing is stored: your files are processed in memory and results disappear when you close the page.
1. Prepare your files
You need two CSV files: one for trainees and one for institutions. Each file lists who each party wants and in what order. The IDs must match between the two files: the institution IDs in the trainee file must be the same IDs used in the institution file, and vice versa.
Trainee preferences
- an ID column with a unique identifier for each trainee
(e.g.
TRAINEE-0012) - one column per preference rank holding the institution's ID for that choice. These IDs must match the IDs in the institution file
- leave a cell blank (or
0) if the trainee has no further preferences
| trainee_id ID | pref_01 1st choice | pref_02 2nd choice |
|---|---|---|
| TRAINEE-0012 | HOSP-SYDNEY | HOSP-MELB |
| TRAINEE-0034 | HOSP-MELB |
Institution preferences
- an ID column with a unique identifier for each institution (must match the IDs used in the trainee file)
- a posts column stating how many trainees this institution can take (a whole number)
- one column per preference rank holding the trainee's ID for that choice. These IDs must match the IDs in the trainee file
| institution_id ID | posts capacity | pref_01 1st choice | pref_02 2nd choice |
|---|---|---|---|
| HOSP-SYDNEY | 2 | TRAINEE-0012 | TRAINEE-0034 |
| HOSP-MELB | 1 | TRAINEE-0034 |
Extra columns for a priority group match
- Trainee file: a
prioritycolumn stating each trainee's priority group (1= matched first,2next, and so on). If you upload one file per priority group instead, no priority column is needed. - Institution file: an optional
no_p1column capping how many priority 1 trainees the institution will take. Leave it blank (or leave the column out) to allow the maximum the percentage rule permits. Caps for later groups (no_p2, …) work the same way.
| trainee_id ID | priority group | pref_01 1st choice |
|---|---|---|
| TRAINEE-0012 | 1 | HOSP-SYDNEY |
| TRAINEE-0034 | 2 | HOSP-MELB |
| institution_id ID | posts capacity | no_p1 priority 1 cap | pref_01 1st choice |
|---|---|---|---|
| HOSP-SYDNEY | 4 | 2 | TRAINEE-0012 |
| HOSP-MELB | 1 | TRAINEE-0034 |
Column names don't need to match these examples. After you choose your files in step 2, the app detects the ID and posts columns automatically and lets you confirm or change which column plays which role, including excluding columns that aren't preferences (e.g. names or notes).
- Each trainee and each institution must appear exactly once in their respective file. Duplicate rows will be rejected.
- Each institution (or trainee) can only appear once per preference list: you can't rank the same place twice.
- Every ID in a preference column must exist in the other file. If an institution ID appears in a trainee's list but isn't in the institution file, the file will be rejected.
Using Excel or Google Sheets?
If your data is in a spreadsheet, export each sheet as a separate CSV file:
- Excel: File → Save As → choose CSV UTF-8 (Comma delimited) (.csv). If your data is on multiple sheets, you need to save each sheet separately.
- Google Sheets: File → Download → Comma Separated Values (.csv). This downloads the currently active sheet, so switch sheets and repeat for each file.
IDs are treated as text, so leading zeros (e.g. 0012) are
preserved.
2. Upload & check
How are your trainee preferences organised?
Institution files asking for more than this are rejected at the check step, so the final result can never exceed it.
3. Run the match
Enabled once your files pass the checks above.
Match history
Showing the last 50 match runs for your organisation.