Branding and Customization | Medplum

Adding Your Logo

Local file

Drop your logo into the static folder:

packages/app/static/img/your-logo.svg

Files in packages/app/static/ are served at the root of your app, so this becomes /img/your-logo.svg.

External URL

Or host your logo elsewhere and use the full URL:

https://cdn.example.com/your-logo.svg

Tip: Use SVG format when possible — they scale perfectly and have smaller file sizes.

Configuration

Add your branding variables to packages/app/.env:

Environment Variables

MEDPLUM_LOGO_URL=/img/your-logo.svg

MEDPLUM_APP_NAME=Your Health Platform

Note: These are build-time variables. You must rebuild the app after any changes.

Then build and run:

cd packages/app

npm run build

npm run dev

For production deployments, see Install from scratch or Install on AWS.

Beyond the app UI

MEDPLUM_APP_NAME and MEDPLUM_LOGO_URL are build-time variables for the app, so they are server-wide and the server itself cannot read them. Content generated elsewhere is branded per Project or per client instead, which is also what lets tenants on a shared server each use their own name:

• appName — a Project.setting entry naming the project in MFA emails, authenticator app entries, and the email sender name
• ClientApplication.signInForm — welcomeString and logo for the login page, per client application
• Project SMTP — sender domain and address for all project emails
• Custom Emails — full control of welcome and password reset email content

Troubleshooting

Logo not showing?

• Check the file exists at the path you specified
• Make sure you rebuilt after changing .env
• Clear your browser cache

App name not changing?

• Variable must be exactly MEDPLUM_APP_NAME

• Rebuild and clear cache

• Adding Your Logo

  • Local file
  • External URL

• Configuration

  • Environment Variables

• Beyond the app UI

• Troubleshooting