Configure emr settings
The EMR (Electronic Medical Records) settings area provides configuration for medical records functionality, including general EMR configuration, clinical rules, and treatment chart management. Use these settings to define how patient medical data is captured, displayed, and documented across your organization.
On this page
- Before you begin
- EMR categories
- Configure EMR sections
- Set up clinical rules
- Manage treatment charts
- Settings reference
- Related articles
Before you begin
- You need administrator access at the organization level.
- The guest medical record feature flag must be enabled for the EMR settings area to appear.
- Clinical rules and treatment charts are part of Treatment Hub. They appear once Treatment Hub is enabled for your organization.
Permission: View, Add, Edit, or Delete (under Medical Record, under Administrator) AND Guest Medical Record (under Guest Manager) β required for EMR configuration. Clinical rules and treatment charts use the Treatment Hub Setup permissions (see Set up Treatment Hub). The Guest Medical Record permission is also required for viewing and managing individual guest medical records during patient encounters.
Click-paths:
- Setup permissions: Configuration > Security > Security roles β select role β Permissions tab β Administrator section β Medical Record
- Data permissions: Configuration > Security > Security roles β select role β Permissions tab β Guest Manager section β Guest Medical Record
Navigation
- Navigate to Configuration > Clinical setup > Medical Record. Clinical setup is available at organization scope only β it does not appear when the scope selector is set to a center.
- The settings page displays available sections based on your permissions and active feature flags.
EMR categories
The EMR system organizes medical records into the following categories. When configuring EMR sections, you define how data within each category is captured and displayed.
| Category | Description |
|---|---|
| Allergy | Track patient allergies including drug allergies, food allergies, and environmental allergies. Allergy records can trigger clinical rules for drug interaction alerts. |
| Medication | Document current and past medications. Medication records integrate with the prescriptions module for comprehensive medication management. |
| Medical history | Capture patient medical history including past diagnoses, surgeries, family history, hereditary conditions, and ongoing conditions. |
| Health & Lifestyle | Record social and lifestyle factors that may affect treatment, such as smoking status, alcohol use, and exercise habits. |
| Vitals | Track vital measurements including blood pressure, heart rate, temperature, weight, and BMI. Vitals can trigger clinical rules when measurements exceed defined thresholds. |
| Critical alerts | Manage critical patient alerts that display prominently on the guest profile, such as severe allergies, contraindicated treatments, or other high-priority clinical notes. Critical Alerts and Notes are always visible on the guest profile and cannot be disabled. |
Configure EMR sections
EMR configuration controls how medical record forms are structured, including form templates, sections, and field configurations. This determines what information providers see and capture during patient encounters.
- Navigate to Configuration > Clinical setup > Medical Record.
- Select the scope level (organization, zone, or center) from the scope selector.
- In the EMR configuration section, the embedded configuration manager opens.
- Configure form templates for each EMR category:
- Define which sections appear on the medical record form.
- Set field labels, field types, and whether fields are required or optional.
- Arrange sections in the order providers should complete them.
- Save your changes.
Tip: Start configuration at the organization level to establish a consistent baseline. Then use zone or center overrides for location-specific requirements.
Scope: Organization, zone, and center levels.
Clinical rules and treatment charts
Clinical rules (contraindication and precaution rule sets) and treatment chart templates are configured in Treatment Hub, at Configuration > Clinical setup > Treatment Hub, at organization level only. They appear once Treatment Hub is enabled for your organization.
To set them up, see Set up Treatment Hub.
Add medical record components to forms
Use the form builder to add Medical Record components (Allergies, Medications, Medical History, Health & Lifestyle) to custom forms.
- Navigate to Configuration > Forms > Form creation > Custom forms.
- Open the form in the form builder.
- Switch to the Data tab.
- Drag a Medical Record component onto the form canvas.
- In Basic Configuration, set the component label and visibility options.
- In Additional Configuration, configure the component-specific settings described in the tables below.
- Save the form.
Note: Medical Record components are only available in forms created with the form builder. Legacy forms do not support Medical Record components.
Additional Configuration options by component
Allergies and Medications
| Option | Values | Notes |
|---|---|---|
| Display type | Radio buttons / Select boxes / or both | Controls how the item list appears to providers |
| Show additional fields when Yes is selected | On / Off | Available only when Radio buttons is selected β not available when Select boxes is the display type |
| Allow adding note for each item | On / Off | Enables a free-text note field per allergy or medication entry |
Medical History
Medical History has two separate enablement toggles:
- Enable Individual Medical History β Tracks conditions specific to the guest.
- Enable Family Medical History β Tracks hereditary conditions in the guest's family history.
Both can be enabled simultaneously. When enabled, providers can set an allergy flag on individual entries to mark conditions that may affect treatment.
| Option | Values | Notes |
|---|---|---|
| Display type | Radio buttons / Select boxes / or both | Controls how the condition list appears |
| Show additional fields when Yes is selected | On / Off | Available only when Radio buttons is selected |
| Allow adding note for each condition | On / Off | Enables a free-text note field per condition entry |
Health & Lifestyle
| Option | Values | Notes |
|---|---|---|
| Allow adding note for each question | On / Off | Enables a free-text note field per lifestyle question |
Set up medical record page structure
Define how medical record categories appear and behave across your organization. The setup uses a guided wizard.
Step 1 β Define Page Structure
- Navigate to Configuration > Clinical setup > Medical Record and open Set up Medical Record.
- Select Define Page Structure to open the configuration wizard.
Step 2 β Configure and reorder sections
- In Configure Sections, toggle each category on or off to control which categories appear on the Medical Records tab:
- Allergies
- Medications
- Medical History
- Health & Lifestyle
- Vitals
- Critical Alerts
- In Reorder Selected Sections, drag and drop the enabled categories into the order providers should see them.
- Select Save & Continue to proceed to per-category configuration.
Steps 3β8 β Configure each category
The wizard steps through each enabled category. For each, complete the configuration and select Save & Continue to advance.
Allergies
- Enter a custom allergen name.
- Select its category from the list.
- Click Add to include it in the allergen database.
- Repeat for each custom allergen, then continue.
Medications
- Enter a custom medication name.
- Select its category.
- Click Add to include it in the medication list.
- Repeat for each custom medication, then continue.
Medical History
- Enter a custom condition name.
- Select its category.
- Click Add to include it in the condition list.
- For each condition, optionally enable the allergy flag to mark it as allergy-relevant for provider review.
- Repeat for each condition, then continue.
Health & Lifestyle
- Select Add Custom Question to add a lifestyle question.
- For each question, configure the answer options.
- Reorder questions using drag-and-drop.
- Continue when finished.
Vitals
- Select Add Custom Vital to add a vital sign.
- For each vital, choose the type:
- Numeric β For measurements with a numeric value (for example, blood pressure, heart rate, weight, BMI).
- Alphabetical β For measurements with a text value (for example, pain scale descriptions).
- Continue when finished.
Critical Alerts Setup
- Select which medical record categories automatically appear as critical alerts on the guest profile.
- Critical Alerts and Notes are always visible and cannot be disabled.
Final step β Save & Finish
After completing all category configurations, select Save & Finish to apply your medical record page structure across the organization.
If your organization has form-data migration enabled, a second main step, Migrate existing data, appears in the stepper after Define Page Structure. It moves data already captured in your custom forms into guests' medical records. See Medical Record Migration Wizard.
Configure security role permissions for EMR
Administrator permissions
- Navigate to Configuration > Security > Security roles.
- Select the target security role.
- Under Administrator > Medical Record, configure:
- View β Access the EMR configuration interface.
- Add β Create new medical record configurations and templates.
- Edit β Modify existing configurations.
- Delete β Remove configurations.
Guest Manager permissions
- In the same security role, navigate to Guest Manager > Guest Medical Record.
- Configure:
- View β View guest medical records on the Medical Records tab.
- Add β Create new records in guest medical records.
- Edit β Modify existing guest medical records.
- Delete β Remove guest medical records.
Data flow considerations
When a guest submits a medical record form for the first time, the form data flows into the Medical Records tab. After the first submission:
- Data no longer flows automatically from forms to the Medical Records tab. Changes made on the Medical Records tab take precedence over form pre-filled data.
- When a guest has multiple appointments on the same day, the system distinguishes between Edited records (modified during the current session) and Backdated records (entered for a prior date).
- To update medical records after the first form submission, providers should use the Medical Records tab directly rather than resubmitting forms.
Settings reference
EMR configuration
| Setting | Type | Description |
|---|---|---|
| EMR configuration | Manager (embedded) | Configure medical record settings, form templates, and field configurations. Manage how patient medical data is captured and displayed across your organization. Available at organization, zone, and center levels. |
Clinical rules
| Setting | Type | Description |
|---|---|---|
| Clinical rules | Manager (embedded) | Create and manage automated clinical rules that generate alerts or require actions based on patient medical data. For example, flag drug interactions, require specific assessments for certain conditions, or alert when vital measurements exceed thresholds. Organization level only. |
Treatment chart
| Setting | Type | Description |
|---|---|---|
| Treatment chart | Manager (embedded) | Create and manage treatment chart templates that define how treatment information is displayed and documented in the Treatment Hub. Templates control section headings, required fields, and documentation format for different treatment types. Organization level only. |