New Learning Moodle Theme Documentation

Last updated: August 17, 2026

Description

A child theme is required for advanced customisations that involve modifying the theme's code, including PHP files. For changes to colours, fonts, spacing, and other visual styles, you do not need a child theme; these can be made using the theme's Custom CSS and other customisation settings.

Support does not cover child themes. Customisations, code changes, and issues related to a child theme are not covered by theme support.

Moodle documentation: Themes overview .

Installation

Child theme installation is the same as a parent theme installation. To install a child theme just go to Site administration > Plugins > Install Plugins, upload a child theme zip file and Moodle will do all the rest.

Shortcodes in a child theme

After installation a child theme you have to set a parent theme name for the Shortcodes Filter plugin. To do it:

  1. Go to: Site administration > Plugins > Filters > Mb2 Shortcodes.
  2. Insert a parent theme name "mb2nl" into the "Custom theme name" field.

Check also shortcodes filter documentation.

Child theme CSS style

To add custom CSS style to a child theme you have to edit: moodle_root/theme/your_child_theme/style/custom.css file.

Child theme SCSS style

To add custom SCSS style to a child theme you have to edit: moodle_root/theme/your_child_theme/scss/style.scss file.

At the top of the "style.scss" file is a code to import style from a parent theme. Do NOT remove this code.

@import '../../mb2nl/scss/style';

How to get a child theme?

To get a child theme files submit a support ticket.