> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getsolum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Form Submissions

> How patient form submissions become patient records

# Form Submissions

When a patient submits one of your forms, Solum tries to match them to an existing patient automatically. If we can match confidently, we update that patient with the new info; if the data is ambiguous, we flag the submission for your review. The patient always sees a success message — their data is captured before any matching runs, so internal issues never cost them their submission.

Manage submissions from [**Submissions**](https://app.getsolum.com/submissions) (or from a specific form's detail page).

<img src="https://mintcdn.com/solumhealth/J2WER_9CJwV9TsWb/images/form-submissions-list.png?fit=max&auto=format&n=J2WER_9CJwV9TsWb&q=85&s=0e503ce71c33828664f7e4e8331118aa" alt="Submissions list with stats and recent submissions" className="mx-auto" style={{ width:"100%" }} width="1280" height="720" data-path="images/form-submissions-list.png" />

***

## How auto-matching works

A submission goes through three matching steps, in order. The first step that finds a confident match wins.

<Steps>
  <Step title="Demographics — exact match">
    If the submission has first name + last name + date of birth, we look for an existing patient with the same three values. Names are case-insensitive; DOB must match exactly.
  </Step>

  <Step title="Phone number + name check">
    If demographics didn't match, we look up the phone number. When we find one, we verify the name is close enough — typos like "Jhon" vs "John" are accepted, but completely different names are rejected and we move on.
  </Step>

  <Step title="Email + name check">
    Same idea as phone, but using email (case-insensitive). The submitted name still has to be close to the existing patient's name.
  </Step>
</Steps>

If a match is found, we update the existing patient with the new form data and the submission moves to **Form Processed**.

<Note>
  If we match a patient but their phone or email belongs to a *different* patient on file, we leave that field unchanged on the matched patient — Solum never overwrites contact info that points to someone else.
</Note>

## When we create a new patient

If no step matches, we create a brand-new patient — provided we have either a unique phone number OR full demographics (first name, last name, DOB). The submission moves to **Form Processed**.

## When we ask for your help (Pending Review)

If we can't match AND can't safely create — for example, the phone is taken by another patient and we don't have a DOB to fall back on — the submission lands in **Pending Review**. The patient still sees a success message; their data is fully preserved.

You'll see how many submissions need attention on the **Pending Review** stat card at the top of the Submissions page:

<img src="https://mintcdn.com/solumhealth/J2WER_9CJwV9TsWb/images/form-submissions-pending-review-card.png?fit=max&auto=format&n=J2WER_9CJwV9TsWb&q=85&s=3a958b1d756883fc6ac6c98cc6b43047" alt="Pending Review stat card" className="mx-auto" style={{ width:"30%" }} width="154" height="146" data-path="images/form-submissions-pending-review-card.png" />

Click the card to filter the table to just those rows.

### Resolving a Pending Review submission

Click **Resolve Conflicts** on a pending submission. You'll see what the patient submitted alongside the existing patient(s) we found, and you choose how to proceed:

<img src="https://mintcdn.com/solumhealth/J2WER_9CJwV9TsWb/images/form-submissions-conflict-resolution.png?fit=max&auto=format&n=J2WER_9CJwV9TsWb&q=85&s=e380a907b91c8fe646a6e145af2e5fd0" alt="Resolve Conflicts dialog showing the submitted data and the matching patient" className="mx-auto" style={{ width:"75%" }} width="672" height="720" data-path="images/form-submissions-conflict-resolution.png" />

| Choice                        | What it does                                                                                                                                                                                                                        |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pick the matching patient** | Links this submission to that patient AND updates their record with the new form info                                                                                                                                               |
| **Create new patient**        | Creates a fresh patient record. If the submission's phone or email is taken by someone else, those fields are skipped on the new record. Not available when the conflict is a name + DOB collision (you'd be creating a duplicate). |

Click **Update & Process** to apply your choice. The submission moves to **Form Processed**.

***

## Submission statuses

| Status             | Meaning                                                        |
| ------------------ | -------------------------------------------------------------- |
| **In Progress**    | Form link sent via a sequence; awaiting the patient's response |
| **Form Completed** | Patient submitted; we're matching them in the background       |
| **Form Processed** | Patient is fully linked, data is live                          |
| **Pending Review** | We couldn't auto-resolve; needs your decision                  |
| **Paused**         | Manually paused by your team                                   |

You can filter the table by any of these via the **All Statuses** dropdown.
