Create an Admin theme
What’s in this topic
This topic describes how to create your custom theme for Magento Admin, referencing the similar flow for creating a custom storefront theme.
To create a custom Admin theme, take the following steps:
- Create a theme directory.
- Add a declaration
- Optionally add
- Optionally change theme logo.
Each step is described further.
Create a theme directory
app/design/adminhtml directory create a new
Add a declaration
In the theme directory, add
theme.xml containing at least the theme name and the parent theme name (if the theme inherits from one). We recommend you to inherit from the default Magento Admin theme:
Add or copy from an existing
theme.xml to your theme directory
Configure it using the following example (replace placeholders with your theme information):
If you change the theme title or parent theme information in
theme.xml after a theme was already registered, you need to open or reload any Magento Admin
page for your changes to be saved in the database.
In your theme directory, create a
In this file, add the following code, having replaced placeholders with your theme information:
Admin theme logo (optional)
In the default
lib/web/images/magento-logo.svg is used as theme logo.
To override it, in your theme directory, create a
web/images sub-directory, and add your custom file named
If you want to use the file with other name and/or format, you need to additionally declare it as described in Declaring theme logo.
Once you open the Magento Admin (or reload any Magento Admin page) having added the theme files to the files system, your theme gets registered and added to the database.
Apply the Admin theme
See the Apply a custom Admin theme topic.