Troubleshooting Common Errors in DigitalPatientChart

DigitalPatientChart errors slow down your practice and frustrate your team. This guide covers the most common issues by module — login, clinical notes, billing, documents, scheduling, and more — with plain-language explanations of why each error occurs and exactly how to fix it.

Login and Access Errors

If you can't log into your patient chart, the cause is almost always one of three things: an expired session token, a credential mismatch, or a browser conflict. Here's how to fix a patient chart login error fast:

1. Clear your browser cache and cookies, then close and reopen the browser.
2. Confirm you're using your practice credentials — not a personal email address.
3. Check that Caps Lock is off. Passwords are case-sensitive.
4. If you see "Account Locked," wait 15 minutes or contact your practice admin to reset access.
5. Try an incognito/private window to rule out a browser extension conflict.
6. If the error persists, use the Forgot Password link on the login screen to reset your credentials.

Why it happens: DigitalPatientChart uses token-based authentication. Corrupted cache data or a forced logout from another device can invalidate your active session without warning.

{{screenshot: DigitalPatientChart login screen with "Forgot Password" link highlighted}}

SOAP Note and Clinical Documentation Errors

If a SOAP note fails to save or returns an error on submission, the note is likely incomplete or contains a field the system requires.

1. Look for red-outlined fields — required fields must be filled before saving.
2. Check that the appointment is marked In Progress or Open. Closed encounters lock the note.
3. If the note auto-saved but won't finalize, click Unlock Note from the encounter menu, make a minor edit, and resubmit.
4. Avoid using special characters (%, &, <, >) in free-text fields — these can trigger a validation error.
5. If you use voice-to-text, paste content into a plain text editor first to strip hidden formatting characters before inserting into the note.

Billing and Claim Submission Errors

A digital patient chart error when submitting forms or claims typically points to a missing field, a payer rejection, or a clearinghouse connection issue.

1. Open the claim and check the Error Details panel — error codes are listed with plain-language descriptions.
2. Confirm the patient's insurance ID and group number match what's on file with the payer.
3. Verify the NPI on the claim matches the rendering provider's NPI in your Settings.
4. For rejection code 835 or 277, the payer returned the claim — review the payer's reason code before resubmitting.
5. If the clearinghouse shows "Connection Timeout," wait 10 minutes and retry. Scheduled maintenance on the payer's end causes most timeout errors.

{{screenshot: Claim error detail panel showing error code and plain-language description}}

Document Upload and File Attachment Failures

When a patient chart file upload fails, it's usually a file size or format issue. Here's how to upload documents to DigitalPatientChart successfully:

1. Confirm the file is under 25 MB. Files over this limit are rejected automatically.
2. Accepted formats: PDF, JPG, PNG, TIFF, and DOCX. ZIP files and executables are blocked.
3. Rename the file to remove spaces and special characters (e.g., rename patient record & notes.pdf to patient-record-notes.pdf).
4. If the upload stalls at 100% without confirming, refresh the document tab — the file may have uploaded despite the display error.
5. On a slow connection, upload one file at a time instead of batch uploading.

Patient Records and Scheduling Sync Issues

If medical records are not syncing in the patient portal, or an appointment is not showing up in the patient chart, a sync delay or a scheduling rule conflict is usually responsible.

1. Allow up to 15 minutes for newly created appointments to appear in the portal. Sync runs on a scheduled interval, not in real time.
2. Confirm the appointment status is set to Confirmed or Scheduled — Draft appointments do not sync to the portal.
3. Check that the patient's portal account email matches the email in their demographic record. A mismatch breaks the link between the record and the portal account.
4. For records that aren't syncing after 30 minutes, open the patient's chart, go to Portal Settings, and click Re-sync Record.

Role-Based and Multi-User Permission Errors

Access errors vary by role. What a front desk user sees is different from what a provider or admin sees — and that's intentional.

• Front desk: Can view and edit scheduling, demographics, and insurance. Cannot access clinical notes or billing.
• Provider: Full access to assigned patient records. Cannot access other providers' patients without admin override.
• Admin: Full practice access. Responsible for assigning roles and resetting permissions.

1. If a user receives an "Unauthorized" error, your practice admin should go to Settings > User Management and verify the user's role assignment.
2. Re-save the user's role even if it appears correct — this refreshes the permission token.
3. Log out and back in after any permission change for the new role to take effect.

Browser, Device, and Compatibility Issues

If the patient portal is not loading on your phone or tablet, a browser compatibility issue is the most likely cause.

• Recommended browsers: Chrome (latest), Edge (latest), Firefox (latest)
• Known issues: Safari on iOS may block pop-up windows used for document previews. Enable pop-ups for the DigitalPatientChart domain in Safari settings.
• Mobile devices: Use the browser version, not a third-party app wrapper, for full feature support.

1. Update your browser to the latest version.
2. Disable browser extensions one at a time to identify any that block scripts.
3. If on a tablet, switch to Desktop Mode in your browser settings for the best experience.

Errors After a Software Update

If the patient chart is not working after an update, a cached version of the old app is almost always the cause — not a bug in the new release.

1. Hard refresh the page: Ctrl + Shift + R (Windows) or Cmd + Shift + R (Mac).
2. Clear all browser cache and cookies, then log back in.
3. If a specific feature is broken post-update, check the Release Notes tab in your admin dashboard — known issues are posted there within 24 hours of a release.
4. Do not roll back or use a bookmarked login URL from before the update. Always access the platform from the current login page.

Integration Errors (Fax, Imaging, and Clearinghouse Connections)

Integration errors mean DigitalPatientChart attempted to connect to a third-party service and the connection failed or returned an unexpected response.

1. Go to Settings > Integrations and check the status indicator next to the affected integration.
2. A yellow status means degraded performance — retry in 15 minutes.
3. A red status means the connection is down. This is usually on the third-party side. Check the vendor's status page directly.
4. For fax failures, confirm the outbound fax number does not include extensions or country codes unless your fax service requires them.
5. For imaging integrations, verify the DICOM server IP and port in your integration settings have not changed after a network reconfiguration at your practice.

Session Timeouts and Auto-Logout Behavior

It is normal for the patient portal to time out after a period of inactivity. DigitalPatientChart automatically logs users out after 20 minutes of inactivity by default. This is a HIPAA-required security control, not a bug.

• Admins can adjust the timeout window to up to 60 minutes under Settings > Security > Session Policy.
• If the patient portal keeps logging you out automatically before 20 minutes, an unstable network connection may be dropping the session. Test on a wired connection or different Wi-Fi network.
• Browser privacy settings that block cookies will force a logout on every page load. Allow cookies from the DigitalPatientChart domain.

When to Contact DigitalPatientChart Support

Most errors resolve with the steps above. If an issue persists, escalate using the right channel to get the fastest resolution. Turnaround time for patient portal access issues is typically 1–2 business days for standard tickets and 4 hours for urgent/priority tickets.

1. Collect the error message text, the time it occurred, and the user role affected.
2. Take a screenshot of the error screen if possible.
3. Submit a support ticket directly from within DigitalPatientChart: go to Help > Contact Support in the top navigation.
4. For billing-critical or patient-safety issues, mark the ticket Urgent to trigger priority routing.

Still Need Help?

If these steps didn't resolve your issue, the Medximity support team is ready to assist.

• Submit a ticket: Use the Help > Contact Support menu inside DigitalPatientChart.
• Live chat: Available Monday–Friday, 8 AM–6 PM ET from your practice dashboard.
• Call support: Contact your account manager directly for billing-critical or access-blocking issues.

For additional guidance on managing your Medximity provider profile and practice settings, visit the Medximity Help Center.