Magnolia 5.4 reached end of life on November 15, 2018. This branch is no longer supported, see End-of-life policy.
Icons add visual value to apps and actions. They help users instantly recognize user interface elements. Icons also add familiarity when used consistently across Magnolia.
Magnolia icon font
Icons used in Magnolia come from the pictographic MagnoliaIcons font. Each icon is a character. The character is a vector format rather than a bitmap, which means you can style the icons with CSS and display them in various sizes without repeating the asset itself.
Icon sizes
Icons are displayed in the following sizes in the user interface.
36 px
App launcher
20 px
Action bar
17 px
Tab
Choosing an icon
When choosing an icon for your own app or action:
- Look through the icons provided in the
MagnoliaIconsfont. Find an icon that represents your app or action well. - Avoid icons that are already used. Using the same icon for two different purposes confuses users and leads to errors.
- If you create your own icons, adhere to the Magnolia design language.
Default icons
Using a custom icon font
To use a custom icon font:
- Create an icon font.
- Create a CSS file which references your custom font.
- In the CSS file, specify classes for your icons. Use a namespace that will prevent collision with Magnolia's native classes. For example
icon-mycompanyname-shop-appinstead oficon-shop-app. - Configure a custom Vaadin theme that is different from the default
admincentraltheme. Your Vaadin theme should includeadmincentraltheme and it needs to compile it. See Using ecustom styles in your Magnolia app.
Overview
Content Tools