Brand new Moodle theme released! Based on Boost and packed with exciting new features.
View Demo

The best way to customise a Boost-based Moodle theme’s default styling

If you’re using a Boost-based Moodle theme and are wondering what is the best way to customise your theme this post is for you. Although lots of Moodle themes allow you to change the theme colour scheme via the theme settings page, there are times you’d like to fine tune the theme design to meet your organisation or client’s specific design requirements. Some of you who’re code-savvy may dive into the theme SCSS files and make changes directly to the original theme files. However, that is NOT recommended. Why? You may ask. That’s because you’ll lose all your customizations should you decide to update your Moodle theme in the future. Unless you’re 100% sure you won’t be updating your Moodle theme in the future or you don’t mind applying your customizations all over again to the new theme version, it’s best to leave all the original theme files untouched.

The best practice is to override your Moodle theme’s default styling via the theme settings page. This is because the customisation will be saved to the Moodle database, and won’t be overwritten when you update the theme files. For all Boost-based themes, you can enter your custom CSS/SCSS code into an input field called “Raw SCSS”. If you’re using one of our premium Moodle themes you can find the input field under the “Advanced Settings” section.

moodle-theme-boost-raw-scss-settings

For example, say you want to change your theme’s base font size and link colour, you can use the CSS code as shown in the figure below. However, the code in the example can only change your theme’s body font size to 18px and the base link colour to red. You’ll probably need to write more targeted CSS code to change some specific elements’ font size or link colour. You can use Chrome DevTools to help you find the right element selector.

moodle theme customise css scss

Want to master Moodle?

Moodle 3.0x Masterclass: Complete Educator's Guide to Moodle

Moodle Tutorial for Educators - Learn Moodle to create WORLD CLASS online courses. Leverage Moodle 3 like a BOSS!

1500+ students enrolled

Are you a Moodle admin?

Moodle Administration Tutorial: Beginner, Intermediate Guide

Learn World Class Moodle LMS Admin, Configure, Theme, Manage Courses, Users, Permissions, Roles, Security, Plugins...

2000+ students enrolled