Note: You are currently viewing documentation for Moodle 3.10. Up-to-date documentation for the latest stable version of Moodle may be available here: Installing a new theme.

Installing a new theme

From MoodleDocs

This page requires updating. Please do so and remove this template when finished.

Setting up a new theme in Moodle is a two step process. First someone has to install the theme in the Moodle site. Second, the theme must be selected for use.

Installing the plugin

Any new theme is a plugin. Please see Installing plugins for details about the three different ways of installing a theme.

Changing the theme

You may select the theme which will be used on three different types of devices that will use your site: a computer with monitor(s), a mobile phone and a tablet. Some themes will can be additionally modified for a specific device.

  1. Log in as admin and go to Administration > Site administration > Appearance > Themes > Theme Selector
  2. Click on the "Change theme" button on the right of the current theme being used for the device
  3. Scroll down to find the theme you wish to use
  4. Click the "Use theme" button next to that theme
  5. Moodle will tell you it has been saved as the default theme
  6. Check your Moodle site


  • You may have to refresh your browser to see the new theme
  • The Moodle server should automatically clear its theme cache
    • Some older versions of Moodle will required you to click on the "Clear theme caches" button as a last step
  • It is a best practice to check how the theme looks by using
    • the three different types of devices and
    • different browsers on those each of those devices

Changing theme images

Click the Change theme button v 3.9
Click Use theme button on the theme you want
Example, no themes selected for some types

See also