This guide covers the most common DigitalPatientChart bugs by role and issue type. Each section includes step-by-step fixes, estimated resolution times, and plain-language explanations so front desk staff, providers, and billing teams can resolve issues without waiting on support.
Content maintained by the DigitalPatientChart team. Reflects the current software version.
1. Login and Access Issues
Estimated resolution time: 2–10 minutes
If you or a patient cannot log in, the cause is almost always one of three things: a locked account, an expired session token, or a browser cache conflict.
Front Desk Staff
- Go to Admin Panel → User Management → Search Patient.
- Check the account status column. If it shows Locked, click Unlock Account.
- If the status shows Pending Verification, click Resend Verification Email.
- Confirm with the patient that the email arrived and instruct them to use the link within 24 hours.
Providers
- Navigate to Settings → Security → Active Sessions.
- Click Revoke All Sessions to clear stale tokens.
- Log out completely, clear your browser cache, and log back in.
- If two-factor authentication (2FA) codes are not arriving, go to Settings → Security → 2FA Method and confirm the delivery method is set to your current email or phone number.
All Roles — Quick Browser Fix
- Open DigitalPatientChart in an incognito or private browsing window.
- If login succeeds, the issue is your browser cache. Clear cache and cookies in your standard browser and retry.
- Supported browsers: Chrome 110+, Firefox 115+, Edge 110+, Safari 16+. Internet Explorer is not supported.
Tip: Learning how to prevent patient portal login problems long-term starts with enforcing password rotation every 90 days under Admin Panel → Security Policies.
2. Appointment Scheduling Errors
Estimated resolution time: 5–15 minutes
Scheduling errors typically appear when provider availability rules conflict with system defaults or when a third-party scheduling integration loses sync.
Steps to Fix an Appointment Scheduling Error Online
- Go to Scheduling → Provider Availability → [Provider Name].
- Check that availability blocks are set for the correct timezone. A timezone mismatch is the most common cause of "no available slots" errors.
- Confirm that appointment types listed under Scheduling → Appointment Types have a duration assigned. Slots with 0 min duration will not display to patients.
- If using an external scheduling tool (e.g., Zocdoc, NexHealth), go to Integrations → Scheduling Sync and click Force Resync.
- Ask the patient to clear their browser cache or use a different browser before retrying.
Front Desk Note
If a specific appointment type is missing from the patient-facing booking screen, check Scheduling → Appointment Types → Visibility and confirm the toggle is set to Patient-Visible: On.
3. Billing and Claims Bugs
Estimated resolution time: 5 minutes (display issue) to 1–2 business days (clearinghouse error)
Two separate issues bring billing staff here: a bill displaying the wrong amount, and an insurance claim not showing in the patient account.
Why Is My Bill Wrong in the Patient Portal?
- Go to Billing → Patient Ledger → [Patient Name].
- Compare the ledger total to what the patient sees in their portal. A mismatch usually means a payment was posted but the portal cache has not refreshed.
- Click Actions → Force Portal Refresh on the ledger screen.
- If the amounts still differ, check Billing → Adjustment Log for unapplied credits or duplicate charges.
- Correct any duplicate entries and click Recalculate Balance.
Insurance Claim Not Showing in Patient Account
- Go to Billing → Claims → Search by Date of Service.
- Confirm the claim status is not stuck on Pending Submission. If it is, click Resubmit to Clearinghouse.
- Check Billing → ERA/EOB → Unmatched Payments for claims that were paid but not auto-applied.
- For ERA matching errors, contact your clearinghouse directly. DigitalPatientChart support cannot override clearinghouse responses, but can help confirm your submission data is correct.
4. Document Upload and File Failures
Estimated resolution time: 2–5 minutes
When a patient reports that medical records upload is not working in the patient portal, or a file upload keeps failing, the fix is almost always a file size or format issue.
- Confirm the file meets these requirements:
- Accepted formats: PDF, JPG, PNG, TIFF
- Maximum file size: 25 MB per file
- Maximum files per upload: 10
- If the file meets requirements but the upload still fails, go to Documents → Upload Log and check the error column for a specific failure reason.
- Files with special characters in the filename (e.g., #, &, %) will fail silently. Rename the file using only letters, numbers, and hyphens, then retry.
- For provider-side uploads to patient charts, go to Patient Chart → Documents → Upload. Do not use the drag-and-drop area in browsers other than Chrome — it is not fully supported in Safari.
- If uploads fail for all patients simultaneously, check System Status → Document Storage for an active service disruption.
5. Mobile vs. Desktop Behavior Differences
Estimated resolution time: 2–5 minutes
The DigitalPatientChart patient portal is optimized for desktop browsers. Mobile users — particularly those asking why the patient portal is not loading on their phone, or why it works on a computer but not a phone — are usually hitting one of two issues: an unsupported mobile browser or a disabled JavaScript setting.
Steps for Mobile Troubleshooting
- Ask the patient which browser they are using on mobile. The portal supports Chrome for Android and Safari for iOS (version 16 or later). Samsung Internet and in-app browsers (e.g., opening from a Gmail link) are not fully supported.
- Instruct the patient to open the portal URL directly in Chrome or Safari — not from an email link inside another app.
- If the portal loads but features are missing (e.g., no appointment booking button), ask the patient to enable JavaScript in their mobile browser settings.
- For iOS users: Settings → Safari → Advanced → JavaScript → On.
- For Android users: Chrome menu → Settings → Site Settings → JavaScript → Allowed.
- If the issue persists, advise the patient to use a desktop browser until mobile-specific fixes are applied. Note the browser and OS version and submit a bug report via Admin Panel → Support → Submit Bug Report.
6. Integration and Sync Errors
Estimated resolution time: 5–20 minutes depending on integration type
When a patient reports that the portal sync is not updating their information, the issue is usually a stalled data sync between DigitalPatientChart and a connected system.
- Go to Integrations → Connected Systems and check the Last Synced timestamp for each integration.
- If a timestamp is more than 4 hours old, click Reconnect next to that integration.
- For lab or imaging integrations, go to Integrations → HL7/FHIR Log and look for failed message entries. A red status on any entry means the receiving system rejected the data — note the error code and reference Section 7 below.
- If your billing module is an external system (e.g., Kareo, AdvancedMD), confirm that the API key under Integrations → Billing → API Credentials has not expired. Keys expire every 12 months.
- After reconnecting any integration, click Force Full Sync to pull all pending data. Allow up to 20 minutes for large datasets to populate.
7. What Common Error Messages Actually Mean
If you or a patient see an error code on the patient portal and want to know what it means, use this reference table.
Error Code / Message Plain-Language Meaning First Step ERR-401 Session expired or not authenticated Log out and log back in ERR-403 User does not have permission to view this record Check role permissions in Admin Panel → User Management ERR-422 Form submission failed — a required field is missing or formatted incorrectly Review all required fields and resubmit ERR-500 Server-side error — not caused by the user Wait 5 minutes and retry; if persistent, submit a support ticket ERR-503 System temporarily unavailable (maintenance or high load) Check System Status page; retry in 15 minutes SYNC-TIMEOUT Integration did not respond in time Go to Integrations → Connected Systems and click Reconnect UPLOAD-REJECTED File failed format or size validation Check file format and size (see Section 4)8. Proactive Tips to Prevent Recurring Issues
Fixing bugs reactively costs more time than preventing them. These habits reduce the most common error types across all roles.
Front Desk Staff
- Run Admin Panel → User Audit → Inactive Accounts monthly. Deactivate accounts unused for 90+ days to reduce lockout-related support requests.
- Confirm new patient accounts are verified (green checkmark in User Management) before the first appointment. Unverified accounts cannot access the portal.
Providers
- Review your availability settings after any schedule change. Stale availability blocks are the leading cause of appointment scheduling errors.
- Keep your browser updated. DigitalPatientChart releases updates every 4–6 weeks. Older browsers may not render new features correctly.
Billing Staff
- Rotate integration API keys before they expire. Set a calendar reminder 30 days before the 12-month expiration date.
- Run Billing → ERA/EOB → Unmatched Payments weekly. Unmatched payments compound over time and cause balance display errors in patient accounts.
All Roles
- Bookmark the System Status page. Check it before submitting a support ticket — many ERR-500 and ERR-503 errors resolve on their own within minutes.
- Use supported browsers only. Unsupported browsers are the single most common cause of issues that appear on mobile but not desktop, or vice versa.
9. When to Contact Support — and How to Escalate Fast
Most issues in this guide resolve without a support ticket. Submit a ticket when:
- An ERR-500 or ERR-503 error persists for more than 30 minutes
- A sync integration has been offline for more than 4 hours after a reconnect attempt
- A billing discrepancy cannot be resolved through the ledger adjustment tools
- A patient is locked out and the unlock steps in Section 1 have not worked
- A document upload fails for all users simultaneously
How to Contact Patient Portal Support Fast
- Go to Admin Panel → Support → Submit Ticket.
- Select the correct category: Login/Access, Billing, Scheduling, Documents, or Integration. Correct categorization routes your ticket to the right team and cuts response time.
- Include the following in your ticket:
- The exact error code or message (screenshot if possible)
- The affected user role (front desk, provider, billing)
- Browser name and version
- Steps already attempted from this guide
- For urgent issues affecting multiple users, select Priority: High. High-priority tickets receive a response within 2 business hours.
- Standard tickets receive a response within 1 business day.
{{screenshot: Support ticket submission form with category dropdown and priority selector highlighted}}
Still Need Help?
If the steps above did not resolve your issue, the DigitalPatientChart support team is ready to help.
- Submit a support ticket: Admin Panel → Support → Submit Ticket
- Live chat: Available Monday–Friday, 8 AM–6 PM ET — click the chat icon in the bottom-right corner of any DigitalPatientChart screen
- System Status: Check real-time platform health at the System Status page before escalating
All help content is maintained by the DigitalPatientChart team and updated with each software release. If a step in this guide does not match what you see on screen, your account may be on a different subscription tier or an older software version. Note your version number (visible under Settings → About) when submitting a ticket.