Installing Themes
Last updated on
6 August 2023
The recommended way to install themes is with Composer.
For Drupal 8 or higher core themes are in a directory named /core/themes
and all contrib or custom themes under a directory named /themes
(in the webroot). Check the detail content of README.txt in the /themes
directory for more info.
- Download the theme.
You can find themes on Download, as well as some external sites. Make sure the version of the theme matches your version of Drupal.
When you first download the theme, it will appear in a compressed file format such as 'tar.gz' or 'zip'. You need to extract the compressed file then you will get a list of files extracted into a folder.
- Upload the folder.
FTP/Copy/SCP your files to the desired themes folder in your Drupal installation. For Drupal 8 or higher core themes are in a directory named/core/themes
and all contrib or custom themes under a directory named/themes
(in the webroot). If you are running a multi-site installation multisite installation, you may also put themes in the sites/all/themes directory, and the versions in sites/all/themes will take precedence over versions of the same themes that are here. Alternatively, the sites/your_site_name/themes directory pattern may be used to restrict themes to a specific site instance.
- Read the directions.
If the theme has an installation file (usually INSTALL.txt and/or README.md), read it for specific instructions. There are themes that require special treatment to function properly.
- Install and make it the active, default theme.
Go to "Appearance"(/admin/appearance)
on the main Administration menu of your site. Click 'Install' to install the theme and click "set as default' to make it the default theme for your website. Alternatively, you can click 'Install and set as default' to install the theme for your website along with making it the default.
If you run into problems, check the themes issue queue and search the forums. If your problem hasn't already been addressed, post a question and someone will try to help you out.
Help improve this page
Page status: No known problems
You can:
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion