The Participants page is the day-to-day management view for a session. It shows every participant along with their form status, invitation status, and contact details. From here you can invite new participants, track progress, review forms, send reminders, and import from a file.
URL: https://app.healthforms.io/manage/sessions/{sessionId}/manage
Required role: Any session or participant role
The grid shows all participants for the current session. Columns:
| Column | Description |
|---|---|
| Status | Color-coded badge showing the participant's overall form status |
| Invitation Status | Whether the invitation has been sent, accepted, or is pending |
| Name | Participant's full name |
| Email address | |
| Group | The group this participant belongs to |
| External Participant ID | Your organization's ID for this participant |
| External Member ID | Your organization's member/system ID |
| Form Packets | Which form packets are assigned to this participant |
| Accepted On | Date the participant accepted their invitation |
| Invitation Code | Unique invitation code |
| Invitation URL | Full invitation link (with copy-to-clipboard button) |
The grid updates in real time — when a participant accepts an invitation or submits a form, their row refreshes automatically.
Access actions from the action menu bar at the top of the grid, or right-click any row for the context menu.
| Action | Description | Required Role |
|---|---|---|
| Invite | Add and invite a new participant | Session Manager, Participant Manager |
| Resend Invitation | Resend an invitation to a participant who hasn't accepted | Session Manager, Participant Manager, Participant Viewer |
| View | Open the participant editor to see full details and forms | Session Manager, Session Viewer, Participant Manager, Participant Form Reviewer, Participant Form Viewer, Participant Viewer |
| Move to Session | Move this participant to a different session | Session Manager, Participant Manager |
| Delete | Remove this participant from the session | Session Manager, Participant Manager |
| Review Forms | Open the bulk form review queue for this session | Session Manager, Participant Manager, Participant Form Reviewer |
| Import | Go to the bulk CSV/Excel import wizard | Session Manager, Participant Manager |
| Reminders | Send invitation or form submission reminders | Session Manager, Participant Manager |
| Export to CSV | Download the participant list as a CSV file, reflecting your current filters, sort order, and visible columns | Session Manager, Participant Manager, Participant Viewer |
Locked sessions: Invite, Resend Invitation, Move to Session, Delete, and Import are all disabled when the session is locked. (Export to CSV stays available — it only reads existing data.)
Click Invite in the action menu. A "Send Invitation" popup opens.
| Field | Required | Notes |
|---|---|---|
| First Name | Yes | Max 50 characters |
| Last Name | Yes | Max 50 characters |
| Email Address | Yes | Must be a valid email address |
| External Participant ID | No | Your internal participant ID; max 75 characters |
| External Member ID | No | Your internal member/system ID; max 75 characters |
| Form Packets | No | Select one or more form packets to assign to this participant |
| Create A New Group | No | Check this to type a new group name instead of selecting an existing one |
| Group | No | Select the group to place this participant in |
| Send Invitation On | No | Schedule the invitation for a future date. Leave blank to send immediately. |
Click Save to invite the participant. They receive an email with their invitation link.
Prerequisites: The session must have at least one form assigned before you can invite participants — if it doesn't, clicking Invite shows the error "You must add a form to the event before sending an invitation." Additionally, inviting requires available participant credits; if your organization has none, you'll see an error and need to upgrade or purchase credits in Billing.
For a participant who was invited but hasn't accepted:
The participant receives a new invitation email. "Resend Invitation" is disabled for participants who have already accepted.
Click Reminders in the action menu for a dropdown:
A confirmation dialog appears before sending. Click Send to proceed.
Click View (or double-click any row) to open the participant editor — a full-page detail view for a single participant.
The editor has four information cards:
Information card (top left):
Insurance card (bottom left):
Emergency Contact card (top right):
Invitation Status card (bottom right):
| Tab | Description |
|---|---|
| Forms | All forms assigned to this participant with their individual status |
| Packets | Form packets assigned to this participant |
| Messages | All invitation and reminder messages sent to this participant |
| History | Audit log of all changes to this participant's record |
Click the pencil icon on the Information card to open the Edit Information popup.
Name section: Title (dropdown, accepts custom values), First Name (required), Middle Name, Last Name (required), Suffix (dropdown, accepts custom values)
Contact section: Phone Number (US format with extension), Email Address
Additional Info section: Date of Birth, Height in inches (0–120), Weight in lbs (0–1500)
Admin section: Group (select), External Participant ID (max 75), External Member ID (max 75)
Click Save to apply changes.
Click the pencil icon on the Emergency Contact card. Fields: Name, Relationship, Address, Mobile Phone, Other Phone, Alternate Name, Alternate Phone.
Select a participant and click Move to Session (or right-click → Move to Session).
| Field | Required | Notes |
|---|---|---|
| Target Session | Yes | Select the destination session from the dropdown |
| Target Group | No | Optionally assign the participant to a group in the target session (loads after selecting the session) |
| Form Packets | No | Select which form packets to assign in the target session |
Important: Forms that exist in both sessions are preserved with their current status. Forms not offered in the target session, or in packets you don't select, will be removed from this participant.
Click Move to transfer the participant. The participant disappears from the current session and appears in the target session.
Select a participant and click Delete (or right-click → Delete). A confirmation dialog appears: "Are you sure you want to delete participant '[Name]'?"
Click Delete to confirm. This removes the participant from the session permanently.
Click Import in the action menu to go to the bulk import wizard, which lets you import multiple participants from a CSV or Excel file. See Participant Import for details.
Either the session is locked, or you don't have the Session Manager or Participant Manager role for this session. If the button is clickable but shows an error, the session may have no forms assigned yet — go to Session Settings → Forms to add one.
Resend Invitation is only available for participants who haven't accepted yet. If the participant has already accepted (Accepted On is set), the action is disabled.
Check that the email address is correct on their record. Try using Resend Invitation to send to an updated address. Ask the participant to check their spam folder.
The participant may have accepted the invitation but not yet started or submitted their forms. Check the Forms tab in the participant editor to see the status of each form. Use Send Form Reminders to prompt them.
Q: How do I add a new participant to a session? A: Click "Invite" on the Participants page, fill in the participant's first name, last name, and email address (required), then click Save. They receive an invitation email immediately (or on the date you set in "Send Invitation On"). The Invite button requires the Session Manager or Participant Manager role.
Q: How do I resend a participant's invitation? A: On the Participants grid, right-click the participant and choose "Resend Invitation," or select them and click Resend Invitation in the action menu. You can update the email address before resending. This is only available for participants who haven't accepted yet.
Q: How do I send reminders to participants who haven't submitted their forms? A: On the Participants page, click "Reminders" in the action menu and choose "Send Form Reminders." This sends to participants who have accepted their invitation but haven't submitted all required forms. Participants receive at most one reminder per day.
Q: How do I see a participant's form status in detail? A: Click "View" on the participant row (or double-click) to open the participant editor. The "Forms" tab shows each form and its current status.
Q: Can I move a participant from one session to another? A: Yes — right-click the participant and choose "Move to Session." Select the target session, optionally assign a group and form packets, then click Move. Forms that exist in both sessions are preserved.
See the Glossary of Terms for definitions of terms used in HealthForms.io.