Patient insurance and card scanning

Patient insurance is managed from the patient's record. Organization-wide insurance settings are managed in Settings → Insurance by owners and admins.

How do I add insurance to a patient?

Use the insurance section in the patient's record to add coverage before you run eligibility checks or build claims. If the patient has no insurance yet, the section shows No insurance on file.

1. In the left sidebar, click Patients, then click the patient's name. In the insurance section, select Add insurance.
2. Choose the payer and enter the member ID.
3. Fill in the subscriber, plan and address details you have.
4. Select Add insurance.

The insurance is saved to the patient record. The first insurance in the list is labeled Primary, the second is Secondary, and any others are numbered. If Ona shows Insurance profile incomplete, the missing fields are marked red in the form.

If you try to save with no insurance details entered, Ona shows Nothing to save and asks you to add at least a payer and member ID. If an address state is required, Ona shows State required before saving. If the subscriber date of birth is incomplete or invalid, Ona shows an inline date of birth error and keeps the half-typed value visible so you can finish it.

How do I scan an insurance card?

Use the Insurance card panel while adding or editing patient insurance. Scanning fills what Ona can read, and the form stays editable.

1. In the left sidebar, click Patients, then click the patient's name. In the insurance section, select Add insurance, or select the edit button on an existing insurance row.
2. In the Insurance card panel, add a Front photo. You can drag and drop a file onto the tile or choose a file.
3. Add Back if you have it.
4. Select Scan and fill.
5. Review the filled fields against the card.
6. Select Add insurance or Save changes.

Card images can be JPEG, PNG, WebP, HEIC or HEIF. Each image must be under 10 MB.

Scanning does not overwrite details you already typed. If the card only confirms values already on the form, Ona keeps the existing values and tells you there is nothing new to fill. If the form shows Insurance profile incomplete, the missing fields are marked red. If the subscriber date of birth is incomplete or invalid, the form keeps the half-typed value visible instead of clearing it.

How do I edit insurance or view the card on file?

Edit an insurance entry from the patient's insurance list when a payer, member ID, subscriber or address detail changes.

1. In the left sidebar, click Patients, then click the patient's name.
2. Select the edit button on the insurance row.
3. If card photos are saved, review them in the Insurance card panel.
4. Select a stored photo thumbnail to enlarge it.
5. Use the replace control to pick a new photo, or the remove control to clear a new photo.
6. Update the insurance details.
7. Select Save changes.

The row updates with the payer name and member ID. Insurance entries can also show Complete or Incomplete. When the profile is incomplete, the missing fields are marked red in the form. If the subscriber date of birth is incomplete or invalid, Ona shows an inline date of birth error and keeps the half-typed value visible instead of clearing it.

How do I remove insurance from a patient?

Remove insurance from the patient's record when that coverage should no longer be on file.

1. In the left sidebar, click Patients, then click the patient's name.
2. Select the remove button on the insurance row.
3. Read the confirmation message.
4. Select Remove.

The insurance is removed from the patient's record. If you remove Primary coverage, the next insurance in the list is promoted to primary.

How do I require insurance during patient intake?

Owners and admins can use Settings → Insurance to require patients to add insurance during patient self-registration and one-time profile links, and to require insurance card photos. The Patient intake section appears when insurance features are enabled.

1. In the left sidebar, click Settings at the bottom. In the settings menu, under Insurance, click Insurance.
2. In Patient intake, turn on Require insurance.
3. To also ask for the card photos, turn on Require insurance card photos.
4. Select Save.

When Require insurance is on, patients must add at least one plan before they can finish intake.

When Require insurance card photos is also on, patients must add front and back card photos before they can finish intake.

What can't I do here?

In Settings → Insurance, patient insurance and insurance settings have a few limits:

• You cannot save a blank insurance entry. Add insurance details before saving.
• You cannot save an insurance entry with an incomplete or invalid subscriber date of birth.
• You cannot scan a card without a Front image. Back (optional) is not required.
• You cannot upload card images larger than 10 MB.
• When Require insurance card photos is on, patients cannot finish intake without front and back card photos.
• Scanning does not replace values already filled in on the form.
• Changes on Settings → Insurance are not saved until you select Save.
• Staff and clinicians do not manage the organization-wide insurance controls shown to owners and admins.
• If insurance features are not enabled, insurance-only settings such as fee schedules are not available from Insurance settings.

Common questions

Why does insurance show as Incomplete?

Incomplete means the saved insurance is missing details counted by Ona's insurance completeness check. In the left sidebar, click Patients, then click the patient's name. Open the row and review the insurance details. If the profile is incomplete, the missing fields are marked red in the form. An incomplete or invalid subscriber date of birth can also block saving.

Can I enter the details manually instead of scanning?

Yes. Scanning is optional. You can enter the payer, member ID, subscriber, plan and address details manually and save the insurance. Subscriber date of birth is validated before saving, and half-typed DOB input stays visible until you finish it.

Does scanning save the card photo?

When you save the insurance after scanning, the card photos are saved with that insurance entry. They appear in the Insurance card panel the next time you edit the entry.

What happens if the scan cannot read the card?

Ona tells you it could not read the card. Enter the details manually, or try again with a sharper photo.

Can a patient have more than one insurance?

Yes. In the left sidebar, click Patients, then click the patient's name. Add another insurance from the patient's insurance section. The first entry is Primary, the second is Secondary, and additional entries are numbered.