HOWTO: Patient self-registration in the Native Patient Portal v6.1

From OpenEMR Project Wiki
Revision as of 17:01, 2 May 2022 by Harley Tuck (talk | contribs) (adding new page to be tidied soon)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Note will tidy up this page shortly...
- HT


This document is an update of the [[HOWTO:_Patient_self-registration_in_the_Native_Patient_Portal]] docs for OpenEMR Patient Portal v6.0. OpenEMR v6.1 contains enough significant updates in both the portal functionality and the EMR interface it that it really does rate a separate document.

The Self Registration v6.0 docs make reference and contain links to using Gmail SMTP, but since that doc was written Gmail has discontinued the SMTP service. So this document will show using mailgun's SMTP in the portal setup, and link to documents discussing obtaining that account. However, since as of this writing mailgun's free-of-cost SMTP account is time-limited, you might want to use a different email forwarding service for your own EMR.


Most portal globals settings (main menu: Administration/ Globals, tab: Portal) may be as desired. However, several of them if missing or mis-configured will generate a generic 'Something went wrong' message when a login or self- registration is attempted.


  • Set Portal Globals to allow the self- registration: "Allow Onsite New Patient Registration' (rectangle, below)
  • Note the two text areas for Google CAPTCHA V2 keys (oval). For v6.1 CAPTCHA verification is required for registration. See the wiki page [[Patient_Portal_v61-CAPTCHA_Setup]]


  • It is possible to use the portal without configuring SMTP to send email notifications of portal registrations and credential changes but you and the patients will see a lot of confusing error messages. For a sample SMTP setup see the wiki page [[Patient_Portal_v61-mailgun_setup]]
  • Self- registering new patients may see an error when attempting to self- register: (to the effect of) 'Something went wrong, check with the clinic' (not pictured). Per the forum, the remedy is to deselect the global in Locale tab, “All Languages Allowed” and/ or select one particular language to be used.



To initiate a self- registration the patient obtains the practice's Patient Portal Login URL and surfs to it.

Please note: when test- registering in your own Onsite Portal, you must be logged out of its OpenEMR or you may get errors and fail!

1. Portal Login Screen

  • Be sure the browser has not auto-filled any user names of passwords into the login form.
  • Click the 'Register' button (oval at lower left).


2. 'Account Registration' screen.

Fill in the required blanks (image below).* File:Image4.pngThe little icon for required items (circle at right) will be used in other portal registration screens.

  • Click in 'I'm not a robot' Captcha checkbox (rectangle)
  • This email is also used as the patient's portal login so must not be the same as other patients in the practice's EMR
  • Click 'Verify Email' (oval at bottom)


4. Email Verified

  • See the message:


  • Locate the email in your Inbox (or maybe Spam box)


  • Open the email:


  • Click the long blue link which will return you to the portal 'Account Registration'
  • Click 'Next' (oval below)


3. Fill in the patient profile information

Again, the required items have the little icon in the text area.* Most of these data are not required for registration but anything entered now will not have to be entered later at the clinic.

  • These fields are the demographics and history information that will be transferred to the new patient's OpenEMR record.
  • If any required items are missed, when the 'Next' button is clicked this screen will return showing them with a red border.
  • Scroll down and click 'Next' at bottom of screen (not shown)


4. Enter insurance

  • Enter 'Self' in 'Insurance Company' if patient has no insurance.
  • Click 'Next' (or may click 'Previous' to return to change entries in first screen)


5. Registration Complete

  • As the panel says, the user may use the step buttons along the top of the panel to return to an earlier section and change the information.
  • Click green 'Send Request' button at lower right.


Registration Email Sent

  • see the message:


6. Portal Credential Reset

  • Locate the Registration email:

Sr61-15.png* A credential reset will be required for the first portal login. Click the link in the rectangle below

  • Note the One Time Verification PIN to be used in the next step (oval)


  • In the linked screen enter new credentials:
    • Create a new password of 12 - 80 characters
    • enter the One Time Pin from email


  • ... and successfully login to the new portal account.


Conclusion/ Notes

Here are some forum posts that might be useful reference.* RE: the 'All languages allowed' setting:* Other peoples' experiences of the 'Something went wrong' error