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

# Manage Patient List

> Navigate the patient database, sort, filter, and add new patients

<img className="block" src="https://mintcdn.com/adhdsimple/T9hpxXt-pVUyr2yq/images/clinical-app/patient-list/01-patient-list-overview.png?fit=max&auto=format&n=T9hpxXt-pVUyr2yq&q=85&s=3a74126570db4bbf97b2e939ea967f45" alt="Patient list page showing table with patient records and column headers" width="1440" height="900" data-path="images/clinical-app/patient-list/01-patient-list-overview.png" />

The Patients page serves as the central database for managing all patient records. View patient information in a sortable table format, access individual patient details, and add new patient records to the system.

<Steps>
  <Step title="Navigate to Patients Page">
    Click **Patients** in the main navigation sidebar to access the patient database.

    The patient table displays essential information:

    * Patient ID numbers (auto-generated)
    * UUID identifiers (development view)
    * Full names and ages
    * Email addresses and phone numbers
    * Direct access to individual patient records
  </Step>

  <Step title="Sort Patient Records">
    <img className="block" src="https://mintcdn.com/adhdsimple/T9hpxXt-pVUyr2yq/images/clinical-app/patient-list/02-patient-list-sorted-by-name.png?fit=max&auto=format&n=T9hpxXt-pVUyr2yq&q=85&s=98fc3f5bdd478902311d7f2de0e4c8a8" alt="Patient list sorted alphabetically by name showing sorting functionality" width="1440" height="900" data-path="images/clinical-app/patient-list/02-patient-list-sorted-by-name.png" />

    Click any column header to sort the patient list by that field. The system supports sorting by:

    * **Patient ID**: Numerical order
    * **Name**: Alphabetical order
    * **Age**: Chronological order
    * **Email**: Alphabetical order
    * **Phone**: Numerical order

    <Warning>
      Sort arrows indicate current sort direction. Click again to reverse the sort order.
    </Warning>
  </Step>

  <Step title="Access Patient Records">
    Click anywhere on a patient row to navigate to their detailed record page. This provides immediate access to:

    * Complete medical history
    * Active medications and prescriptions
    * Appointment scheduling
    * Contact information management

    The table supports direct navigation without additional confirmation steps.
  </Step>

  <Step title="Add New Patients">
    <img className="block" src="https://mintcdn.com/adhdsimple/T9hpxXt-pVUyr2yq/images/clinical-app/patient-list/03-add-patient-dialog.png?fit=max&auto=format&n=T9hpxXt-pVUyr2yq&q=85&s=6a71b7698ecf32be9dd7382569318ecc" alt="Add New Patient dialog showing required fields for patient registration" width="1440" height="900" data-path="images/clinical-app/patient-list/03-add-patient-dialog.png" />

    Click the **Add Patient** button to register new patients in the system.

    Required information includes:

    * First and last names
    * Date of birth (DD/MM/YYYY format)
    * Phone number with country code
    * Email address for communications

    <Warning>
      All fields marked with \* are mandatory. The system validates email format and phone number structure before submission.
    </Warning>

    Click **Add Patient** to save the record or **Cancel** to discard changes.
  </Step>
</Steps>

## Additional Features

**Pagination Controls**: Use the "Rows per page" dropdown to adjust table display. Navigation buttons allow browsing when patient records exceed display limits.

**Data Display**: The UUID column is available in development mode for technical troubleshooting and system integration purposes.

## Troubleshooting

**Loading Issues**: If the patient list appears empty, check your network connection and refresh the page. Contact system administration if problems persist.

**Sort Not Working**: Ensure you're clicking directly on the column header text or arrow icon. Some columns may not support sorting based on data type.
