Skip to main content
You can bulk upload candidates into Great Question from a CSV file, useful for loading an existing participant database, adding a new batch of people, or shortlisting candidates straight into a study.

​
Before you import

Make sure your file is ready:
  • It must be a CSV file (.csv).
  • Column headers must appear in the first row.
  • Ensure quotes are correctly paired if any field uses them.
  • Only import the data you actually need.
  • Use YYYY-MM-DD format for any date fields.
  • Each row needs a valid email address (or another unique identifier, if enabled).

​
Option 1: Import from the Candidates page

  1. Go to the Candidates page.
  2. Click Add Candidates → Import from CSV.
  3. Upload your file.
  4. Map fields in your CSV to existing candidate attributes.
  5. Adjust import settings (see below).
  6. Confirm the import.
CSV import can be disabled for your workspace. If it is, you’ll see a lock icon and a message that your workspace admin has turned it off, ask an Admin to enable it.

​
Option 2: Import within a study

You can also import directly from inside a study. Candidates are added to your main candidate database and shortlisted automatically to that study at the same time.

​
Import settings

During import you can configure:
  • Import name — a label for this batch.
  • Candidate update process — how to handle candidates that already exist.
  • Contact access — who can contact the imported candidates. This setting only appears on accounts with Teams enabled.
  • Shortlist to a study (optional).
  • Unique identifier — Email, or a custom attribute flagged as unique.
  • Bulk attributes — apply an attribute value to every candidate in the import.
A custom attribute can only be used as the unique identifier for matching and updating existing candidates, if every row in your file is brand new, the import falls back to matching on email.
You’ll receive an email confirmation when the import completes.

​
Troubleshooting

Still need help? Contact us at support@greatquestion.co — median response time is 19 minutes during support hours.