Adding and managing participants

6 min read · Updated 2026-10-30

In Welphi, each process needs a list of the participants you want to invite to one or more rounds of your questionnaire. This article shows you how to build and manage that list.

Overview

  • Custom fields – extra information about each participant.
  • Adding participants one by one – type each participant's details.
  • The participants list – views, search and participation in rounds.
  • Importing participants from a CSV file – add a long list at once.

Opening the Participants page

The participants list is managed on the process page:

  1. Click the process name on the home page.
  2. Click the "participants" link (for example "0 participants") at the bottom of the screen. The same link is also on the "Round details" screen.

The "Participants" page shows how many participants are in the process and three buttons:

  • "Custom fields"
  • "Import CSV"
  • "+ Add participant"

There are two ways to add your participants: one by one, or by importing a CSV file. You can add as many participants as you want.

Custom fields

Besides the e-mail address and name, a participant can have custom fields. You create them to add further information about participants (for example, country, institution or area of expertise).

Custom fields can also be used to filter statistics by group (see Letting participants filter statistics by group). It is easier to create them before you add participants, so that you can fill them in as you go.

Adding a custom field

  1. Click "Custom fields".
  2. Type the name of the new field and, optionally, a description.
  3. Click "Add field".

Editing or deleting a field

In the same window you can "Edit" or "Delete" each field. A field used in a statistics filter can't be deleted.

The Custom fields window
Custom fields window

Adding participants one by one

  1. Click "+ Add participant". The "New participant" panel opens on the right.
  2. Type the participant's "E-mail" and "Name". Both are required.
  3. If you created custom fields, fill them in under "Custom fields" (they are optional). Click "Manage fields" to create a new field without leaving the panel.
  4. Under "Participation in rounds", choose "Include" or "Exclude" for each round.
  5. Click "Add".
The New participant panel
New participant panel

If the participant is already registered in Welphi (for example, because they answered another Welphi questionnaire), their account is reused.

Editing a participant

  1. Click the arrow (›) at the end of the participant's row, in either view. The "Edit participant" panel opens.
  2. Change what you need.
  3. Click "Save".

For data protection reasons, the name and e-mail can't be changed once the participant's account is active or the participant takes part in other processes. Welphi then shows "The name and email can't be changed: the account is already active or takes part in other processes."

Only the participants themselves can then change their name.

The participants list

Views

The list has two views:

  • "List" – shows each participant's name, e-mail, custom fields and the rounds they are included in ("Included in").
  • "By rounds" – shows whether each participant is included in each round. Choose "Summary" to see one column per round, or "Full" to also see, for each round, when the participant was "Invited by e-mail", "Started" and "Completed".

Use the search box ("Search by name or email") to find a participant.

Participants list (List view)
Participants list
Participants list (By rounds view), showing each participant's status in round 1 (closed) and round 2 (in progress)
Participation in each round

Including or excluding participants from a round

In the "By rounds" view, click a cell to change that participant's participation in that round. Please keep in mind:

  • Only the last round can be changed while it isn't running, and only for participants who haven't started it.
  • In a running round, participants can only be included, not excluded.

Acting on several participants at once

  1. Check the box next to each participant (or the box in the header to select everyone).
  2. Choose an action in the bar that appears at the bottom of the list.

The bar has these actions:

  • "Include in…"
  • "Exclude from…"
  • "Clear selection"
  • "Remove from process…"
Actions for the selected participants
Actions for selected participants

Removing a single participant

Open the participant's panel and click "Remove from process…".

Importing participants from a CSV file

When you have a long list of participants, import them all at once from a CSV file.

Choosing the file

  1. Click "Import CSV". The "Import participants" window opens.
  2. Under "File template", check the columns Welphi expects (see below). Click "Download template (.csv)" to get a file with these headers.
  3. Fill in the template in Excel or another spreadsheet, one participant per line, and save it as CSV.
  4. Click "Choose file…" (or drag the file into the window).
  5. If you want to replace the current list, check "Remove all current participants before importing".
  6. Click "Analyse →".
The Import participants window
Import participants window

The file template

The template has these columns:

  • "Name" – required.
  • "E-mail" – required.
  • One column for each custom field of this process – optional.

The first line of your file must be the header.

Welphi detects the separator (comma, semicolon…) and the encoding automatically, so you don't need to check them yourself. Files exported from Excel that are not in UTF-8 are fixed automatically; check the names in the preview.

Checking the preview

Welphi then shows what will happen ("Import · what will happen"):

  • File details – the file name, number of data lines, separator ("Automatic", with the detected separator), header and encoding.
  • "What each column is" – the field each column will be imported to, with sample values. A column can only go to the field with the same name.
  • "Line by line" – every line of the file, with filters such as "All" and "New", so you can check names and e-mails before importing. Lines with problems (for example, a repeated line or a repeated column name) are flagged here.

Finishing the import

From the preview, you can:

  • "Download report" – keep a copy of this check.
  • "← Choose another file" – start again.
  • The import button (for example "Import 2 and update 0") – import the new participants and update the existing ones.
The import preview
Import preview

That's it! All your participants are added, with the information in the file.