User Configuration | Medplum

On this page

The UserConfiguration resource is used to configure user-specific settings or settings that you want a group of users to share. To do this, you need to create a UserConfiguration resource and reference it in each of the Users's ProjectMembership resources that you want to apply the settings to.

For example:

{

"resourceType": "ProjectMembership",

"userConfiguration": {

"reference": "UserConfiguration/<your-user-configuration-id>",

"display": "User Configuration Name"

},

//...

}

Custom Menu on the Medplum App Sidebar [​](/content/docs/access/user-configuration#custom-menu-on-the-medplum-app-sidebar "Direct link to Custom Menu on the Medplum App Sidebar"/index.html)

The Medplum App has a sidebar that displays a list of resources.

You can add a custom menu to the sidebar by setting the UserConfiguration.menu field. Notice that the target is a FHIR path query that can include filters, sorting, paging, etc.

{

"resourceType": "UserConfiguration",

"menu": [\
\
    {\
\
      "title": "My Custom Menu",\
\
      "link": [\
\
        {\
\
          "name": "Patient",\
\
          "target": "/Patient"\
\
        },\
\
        {\
\
          "name": "Practitioner",\
\
          "target": "/Practitioner"\
\
        },\
\
        {\
\
          "name": "Observations - Heart Rate",\
\
          "target": "/Observation?code=http://loinc.org|8867-4"\
\
        }\
\
      ]\
\
    }\
\
  ],

//...

}

User-specific FHIR Quota Rate Limits [​](/content/docs/access/user-configuration#user-specific-fhir-quota-rate-limits "Direct link to User-specific FHIR Quota Rate Limits"/index.html)

The UserConfiguration.fhirQuota field is used to configure a custom FHIR quota for a Bot, User, or ClientApplication. See FHIR Quota Rate Limits for more information.

For example:

{

"resourceType": "UserConfiguration",

"option": [\
\
    {\
\
      "id": "fhirQuota",\
\
      "valueInteger": 60000\
\
    }\
\
  ],

//...

}