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

# Patient Management

> How to register new patients, search existing records, update patient details, and view the complete patient history timeline.

Every person who visits your clinic needs a patient record. This is the permanent file that holds their name, contact details, medical history, allergies, and a link to every visit, prescription, lab test, and procedure they have ever had at your clinic.

***

## Before You Start

* You need the **Healthcare Administrator** or **Healthcare Practitioner** role to create and update patient records.
* Reception staff typically create new records when a patient arrives for the first time.

***

## Registering a New Patient

1. Go to Healthcare workspace → Masters card → **Patient** → New

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/bizaxloptimizationsllp/images/placeholder-clinic-patient-form.png" alt="New Patient form showing first name, last name, gender, date of birth, mobile, email, and medical history fields" />
</Frame>

2. Fill in the patient's details:

| Field            | What to Enter                                            | Required? |
| ---------------- | -------------------------------------------------------- | --------- |
| First Name       | Patient's first name                                     | Yes       |
| Last Name        | Patient's last name                                      | No        |
| Gender           | Male, Female, or Other                                   | Yes       |
| Date of Birth    | Patient's date of birth                                  | No        |
| Mobile           | Mobile phone number (used for SMS notifications)         | No        |
| Email            | Email address (used for lab results and portal login)    | No        |
| Allergies        | Any known allergies (drug, food, environmental)          | No        |
| Medication       | Medications the patient is currently taking              | No        |
| Medical History  | Significant past conditions, surgeries, hospitalisations | No        |
| Surgical History | Previous surgeries                                       | No        |
| Occupation       | Patient's occupation                                     | No        |
| Blood Group      | A+, B+, O-, etc.                                         | No        |

3. Click **Save**

The system assigns a patient ID automatically (HLC-PAT-YYYY-00001 format). The patient's status is set to **Active** by default.

***

## Optional: Registering a Patient Fee

If your clinic collects a registration fee for new patients:

1. After saving the patient, a payment popup appears automatically (if enabled in Healthcare Settings)
2. Collect the fee and record the payment
3. The fee is invoiced and linked to the patient record

***

## Inviting the Patient to the Portal

Patients can book their own appointments and view their results online through the patient portal. To enable this:

1. Open the Patient record
2. Tick the **Invite as User** checkbox
3. Save

The system sends an email invitation to the patient's email address. Once they set a password, they can log in at your clinic's portal URL.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/bizaxloptimizationsllp/images/placeholder-clinic-patient-portal-invite.png" alt="Patient record showing the Invite as User checkbox and User ID field filled in after invitation is sent" />
</Frame>

***

## Searching for an Existing Patient

1. Go to Healthcare workspace → Masters card → **Patient**
2. Use the search bar at the top of the list to search by name, phone number, or patient ID
3. Click the patient's name to open their record

Alternatively, use the global search bar at the top of the screen and type the patient's name. Patient records appear in the global search results.

***

## Updating Patient Details

Patient details should be kept current - especially mobile number and email, which affect SMS/email notifications and portal access.

1. Open the patient record
2. Edit any field directly
3. Click **Save**

Changes are saved with an audit trail showing who made the update and when.

***

## Adding Patient Relations (Emergency Contacts)

For patients who have a next-of-kin or guardian:

1. Open the Patient record
2. Scroll to the **Patient Relation** table
3. Add the relation's name, relationship type, and contact details
4. Save

This information is available to doctors and nursing staff during emergencies.

***

## Viewing the Patient's Full History

The Patient History page shows a complete chronological timeline of every record ever created for a patient: appointments, consultations, vital signs, lab tests, prescriptions, procedures, and notes.

**To open Patient History:**

1. Click the **Patient History** shortcut on the workspace
2. Search for the patient by name
3. The timeline loads with the most recent records at the top

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/bizaxloptimizationsllp/images/placeholder-clinic-patient-history.png" alt="Patient History page showing search bar at top and a timeline of records below including appointments, encounters, lab tests, and vital signs" />
</Frame>

You can filter the timeline by record type (show only lab tests, or only consultations, etc.) using the filter buttons.

***

## Field Guide: Patient Record

| Field             | What It Contains                                              |
| ----------------- | ------------------------------------------------------------- |
| First Name        | Patient's given name (required)                               |
| Last Name         | Patient's family name                                         |
| Patient Name      | Auto-filled full name (First + Last)                          |
| Gender            | Male, Female, or other                                        |
| Date of Birth     | Used to calculate age at consultation                         |
| Mobile            | Primary contact for SMS notifications                         |
| Email             | Used for lab results, portal login, and portal invite         |
| Blood Group       | ABO and Rh group                                              |
| Status            | Active (normal) or Disabled (not usable for new appointments) |
| Inpatient Status  | Shows if the patient is currently admitted (auto-managed)     |
| Customer          | Linked billing record in BAS for invoicing (auto-created)     |
| Allergies         | Free text field for known allergies                           |
| Medication        | Current medications                                           |
| Medical History   | Past conditions and treatments                                |
| Surgical History  | Previous operations                                           |
| Occupation        | Patient's job (useful for occupational health assessments)    |
| Patient Relation  | Table of emergency contacts or guardians                      |
| Report Preference | Whether the patient prefers Email or Print for results        |

***

## Troubleshooting

**A patient cannot log in to the portal**
Check that their email address is correct on the patient record and that the "Invite as User" option was saved. If they did not receive the invitation email, use the email tool in BAS to resend the invitation.

**A patient's status shows as Disabled**
Open the patient record and change the status back to Active. Disabled patients cannot be booked for new appointments.

**Duplicate patient records exist for the same person**
Decide which record is the primary one (usually the one with more history). Contact your Healthcare Administrator to merge or deactivate the duplicate.

**The mobile number field shows an error when saving**
Ensure the mobile number is in the correct format. Remove any spaces or special characters.

***

## Best Practices

* Register the patient before the first appointment rather than during check-in - having the record ready saves time at the front desk
* Always record the mobile number - it is needed for appointment reminders and lab result notifications
* Add known allergies at registration, not after the first consultation - this protects the patient from the first visit
* Use the "Invite as User" option for patients who are tech-comfortable - it reduces calls to the front desk about appointment details and results
* Keep the status field accurate - do not disable a patient record unless the patient has formally left your clinic, since this prevents booking

***

## Related Features

* [Appointments](/health-wellness/general-clinic/appointments): The next step after registration is booking an appointment
* [Consultations](/health-wellness/general-clinic/consultations): The doctor's record of each visit, linked to the patient
* [Billing and Finance](/health-wellness/general-clinic/billing-finance): Patients are linked to billing via the Customer record
* [Patient Portal](/health-wellness/general-clinic/patient-portal): Gives patients online access to their records
