Modern UI documentation
Modern UI Theme Guide
Build a Moodle experience that feels unmistakably yours.
Modern UI is a configurable Boost child theme for Moodle 4.5 and later. This guide takes you from a clean installation to a complete visual system—without Moodle core edits.
Start here
Take these three steps in order for the most predictable setup.
- 1Install the theme
Place the clean release folder in
Go to installation →theme/modernuiand complete the Moodle upgrade. - 2Add your brand
Choose a preset or set your logo, colours, typography, and layout.
Customise appearance → - 3Shape the experience
Select navigation, footer, course, dashboard, and login presentations.
Explore the guide →
01
Installation
Modern UI requires Moodle 4.5 or later, the bundled Boost parent theme, and a PHP/database combination supported by your Moodle release.
- Back up first.Back up your Moodle code, database, and moodledata before changing a production site.
- Use a clean theme folder.Replace the existing directory with the release archive’s
modernuidirectory. Do not merge over an older copy. - Run the Moodle upgrade.From your Moodle root, use the official CLI command below.
php admin/cli/upgrade.php --non-interactive
php admin/cli/purge_caches.php02
Appearance
Open Site administration → Appearance → Themes → Modern UI. Start with a brand preset, then adjust only the settings your organisation needs.
Recommended order
- Upload light and dark logo variants.
- Choose primary, text, surface, and focus colours.
- Select system, Google, or uploaded typography.
- Review the result in both light and dark presentation where enabled.
05
Learning experience
Configure dashboards, course catalogues, course cards, profiles, H5P presentation, and page templates around the learner’s next action. Page design remains permission-aware in Design this page on the target page while editing is enabled.
06
Login page
Select a login presentation that suits your audience and authentication flow. Always test manual login, external identity providers, password reset, and error messages before publishing a new design.
Explore the live login style gallery →07
Accessibility
Use the built-in contrast feedback, keep focus-visible states distinct, provide meaningful image alternatives, and test the full learner path with keyboard-only navigation. Reduced-motion preferences are respected by supported effects.
08
Advanced
Add custom CSS only after exhausting the theme settings, and document every override for future upgrades. Advertising supports managed image/video campaigns and a structured Google AdSense provider; establish consent before allowing third-party requests.
No guide sections match your search.