How to: Add Icons to my Menu UI Plugin in Release

Question

How can I add icons to my Menu UI plugin in Release?

Reference:

https://docs.digital.ai/release/docs/how-to/extend-the-xl-release-user-interface

The custom menu item looks very off compared to other menu items without an icon.

Answer

You can add a field called icon in the menu-item section to achieve this.

Sample:

<plugin xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns="http://www.xebialabs.com/deployit/ui-plugin"
        xsi:schemaLocation="http://www.xebialabs.com/deployit/ui-plugin xl-ui-plugin.xsd">

    <menu-ref ref="xlrelease.menu.Main">
        <menu id="xlrelease.menu.Custom" label="Custom" weight="45">
            <menu-item label="Empty page" icon="rocket" uri="" weight="-1" path-suffix="custom/
               emptypage"/>
        </menu>
    </menu-ref>
</plugin>

List of available icons:

https://zeroheight.com/4a9ac476a/p/13a447-icons/b/43c8ca