RankList
A plain-English guide to using the residency rank list, application tracker, predictor, analytics, backups, and finalization tools.
Best First Path
If you are new, follow this order. You do not need to use every advanced feature on day one.
1. Sign in
Use Google so your work can sync to the cloud.
2. Add programs
Add one program manually, or import many through Quick Entry.
3. Track interviews
Move programs through saved, applied, interviewing, and ranked stages.
4. Score and rank
Use notes, evidence, and comparisons to build your final list.
5. Back up
Keep cloud sync on and export a backup pack before major changes.
6. Finalize
Create snapshots and certification records before submitting in NRMP R3.
1. Sign In and Sync
RankList opens behind a Google sign-in gate so your private workspace can be connected to your account.
- Open RankList.
- Click Sign in with Google.
- Choose the Google account you want to use for this application season.
- Wait for the main RankList screen to load. When you are signed in, cloud sync can save your changes automatically.
- To leave the app, open the account menu and choose Sign Out. The app should return to the Google sign-in screen.
Tip: Use the same Google account on every device. Switching accounts can make it look like your data disappeared because each account has its own workspace.
2. Add Your First Programs
The Programs screen is your main board. Every other tool becomes more useful after programs are added.
Add one program manually
- Click Start Here or Add First Program.
- Enter the program name, specialty, city/state, and any early notes you have.
- Add interview status, signal status, NRMP code, visa notes, or other details if you know them. Leave unknown fields blank.
- Click Save. The program appears on your active board.
Rank programs
- Go to Programs.
- Drag programs up or down to change the order.
- Use shortlist, active, interview, and archive controls to keep the board clean.
- Open a program again whenever you need to update notes, scores, or evidence.
3. Import Many Programs with Quick Entry
Use Quick Entry when you have a spreadsheet, ERAS-style CSV, or a list pasted from another document.
- Open Ranking, then choose Quick Entry.
- Paste your list into the text box, or use the ERAS CSV template/import options.
- Review the preview. RankList will try to detect program names, specialty, city/state, interview date, and notes.
- Check for duplicates or missing fields.
- Click the import button to create the programs.
For non-technical users: It is okay if your first import is imperfect. Import the list, then open individual programs later to clean up details.
4. Track Applications and Interviews
The interview and application tools help you remember what happened, what is due, and what still needs follow-up.
- Open Interview Pipeline to track interview invites, dates, notes, and thank-yous.
- Open ERAS 2027 for application-season planning: checklist, signals, letters, Scholarly Work, reminders, interview questions, and cost planning.
- Use Timeline to see important events in order.
- Use Inbox or notes fields to capture reminders from emails, interview days, or advisor conversations.
Best practice: After every interview, immediately write down culture impressions, concerns, people you met, and whether a thank-you was sent.
5. Score Programs and Keep Evidence
RankList is strongest when your list is based on written reasons instead of memory alone.
- Open a program from the board.
- Fill in overview details, signal strategy, visa information, geography, and interview notes.
- Use scoring fields for culture, commute, training fit, prestige, workload, family fit, or other categories shown in the app.
- Add evidence notes when something supports or contradicts your score.
- Use Dossier to review one program in depth.
- Use Review Queue to find programs with missing data, contradictions, or low-confidence scores.
6. Compare Programs When You Are Stuck
- Use Compare when you want a side-by-side score breakdown.
- Use Pairwise to decide between exactly two programs.
- Use Tournament for repeated head-to-head decisions when your list feels fuzzy.
- Use Blind Mode to reduce bias by hiding parts of the current rank context.
- Use Regret Check to ask, "Which choice would I regret less later?"
- Use Scenario Lab to test different weighting models before changing your real board.
7. Use Predictions Carefully
The Match Predictor, program-specific match estimates, dashboard odds, and couples tools are planning aids. They are not guarantees and do not replace advisor guidance.
- Open Match Predictor.
- Fill in your applicant profile as honestly as possible.
- Review the confidence label. Low-confidence predictions need more data before you rely on them.
- Use the recommendations to guide questions like "Do I need more interviews?" or "Should I broaden my application list?"
- Do not treat any percentage as deterministic. It is a directional estimate.
Important: Predictions are advisory. Actual Match outcomes depend on program behavior, applicant pool, interviews, rank order strategy, NRMP rules, and many factors no app can fully know.
8. Analytics and Reference Views
- Use Dashboard for a high-level picture once you have programs and interviews.
- Use Intelligence, Score Histogram, Evidence Cloud, and Weekly Digest to find patterns in your data.
- Use SGU Matches and Caribbean school match pages to research historical placement patterns.
- Read the source/currentness labels on reference screens. Some datasets are historical, aggregated, or estimated.
- Use SOAP / Scramble as a readiness planning tool, not as a prediction of needing SOAP.
9. Couples Match
- Open Couples Match.
- Add both partners' preferred programs, geography, risk tolerance, and notes.
- Create paired ranks where both applicants have a possible outcome.
- Use advisory pair suggestions to find geography and score tradeoffs.
- Review "No Match" contingencies carefully before finalizing paired ranks.
Reminder: Couples matching belongs to NRMP. RankList helps organize pairs but does not submit or simulate the official NRMP algorithm exactly.
10. Back Up Your Data
Use more than one backup method. Browser storage can be cleared by the browser or operating system.
- Stay signed in with Google for Cloud backup.
- Watch the Backup indicator near the top controls: Cloud, Local, Local + Cloud, Manual, or Off.
- Open Settings and click Backup Pack before major edits. This creates a portable backup with attachments.
- Click JSON if you want a raw data export.
- For Chromium browsers such as Chrome or Edge, click Local Sync or Link File to continuously write a JSON backup to your hard drive while the tab is open.
- To restore data, use Import and choose a backup file.
Simple rule: Before big changes, export a Backup Pack. Before final submission season, export another one.
11. Settings, Themes, and Workspaces
- Use Light/Dark to switch the visual theme.
- Open Settings to adjust scoring weights and strategy presets.
- Save a workspace when you want to preserve a scoring scenario for later.
- Use import/export tools from Settings when moving data or creating a backup.
12. Finalize Your Rank List
- When the list feels stable, open Snapshots.
- Create a named snapshot such as "After all interviews" or "Final advisor review".
- Use snapshot comparisons to see what changed.
- Open Final Packet to review the list and supporting notes.
- Open Certification to seal a final record for your own audit trail.
- Submit your official rank order list in the NRMP R3 system. RankList does not submit to NRMP.
Critical: RankList is an organizational tool. You must still officially certify and submit your rank list through NRMP.
13. Troubleshooting
I signed out and still see the app
Refresh the page. The app should return to the Google sign-in gate. If it does not, clear the tab and reopen RankList.
I clicked Local Sync and nothing happened
Local file sync only works in Chromium browsers such as Chrome, Edge, and Brave. Safari and Firefox may not show the file picker.
I cannot find a feature
Use the Search button or press Cmd/Ctrl + K, then type the feature name.
My data looks missing
Check that you signed in with the same Google account. Also try importing your most recent Backup Pack or JSON file.
The app feels overwhelming
Use only Programs, Interview Pipeline, Settings backup, and Snapshots at first. Add advanced tools later.