Icons

elementary.io Blog Human Interface Guidelines Contributor Guide
Search…
Icons
The last thing we need for a minimum-viable-app is to provide app icons. Apps on elementary OS provide icons hinted in 6 sizes: 16px, 24px, 32px, 48px, 64px, and 128px. These icons will be shown in many places throughout the system, such as those listed below:
Size
AppCenter
Applications Menu
Dock
Menus & Popovers
Multitasking
Notifications
16px
✖️ No
✖️ No
✔️ Yes
✔️ Yes
✔️ Yes
✖️ No
24px
✖️ No
✖️ No
✖️ No
✖️ No
✔️ Yes
✔️ Yes
32px
✖️ No
✔️ Yes
✔️ Yes
✔️ Yes
✔️ Yes
✖️ No
48px
✔️ Yes
✖️ No
✔️ Yes
✖️ No
✔️ Yes
✔️ Yes
64px
✔️ Yes
✔️ Yes
✔️ Yes
✖️ No
✔️ Yes
✖️ No
128px
✔️ Yes
✖️ No
✖️ No
✖️ No
✖️ No
✖️ No
To help you provide the necessary sizes—and for this tutorial—Micah Ilbery maintains an icon template project here on GitHub​
Place your icons in the data directory and name them after their pixel sizes, such as32.svg, 64.svg, etc. The file structure should look like this:
1
hello-again
2
    data
3
        16.svg
4
        24.svg
5
        32.svg
6
        48.svg
7
        64.svg
8
        128.svg
Copied!
Now that you have icon files in the data directory, add the following lines to the end of meson.build to install them .
1
# Install our icons in all the required sizes
2
icon_sizes = ['16', '24', '32', '48', '64', '128']
3
​
4
foreach i : icon_sizes
5
    install_data(
6
        'data' / i + '.svg',
7
        install_dir: get_option('datadir') / 'icons' / 'hicolor' / i + 'x' + i / 'apps',
8
        rename: meson.project_name() + '.svg'
9
    )
10
    install_data(
11
        'data' / i + '.svg',
12
        install_dir: get_option('datadir') / 'icons' / 'hicolor' / i + 'x' + i + '@2' / 'apps',
13
        rename: meson.project_name() + '.svg'
14
    )
15
endforeach
Copied!
You'll notice the section for installing app icons is a little more complicated than installing other files. In this example, we're providing SVG icons in all of the required sizes for AppCenter and, since we're using SVG, we're installing them for both LoDPI and HiDPI. If you're providing PNG icons instead, you'll need to tweak this part a bit to handle assets exported for use on HiDPI displays.
If you cannot see your new icon in the Applications Menu or the Dock once you've reinstalled your app, refresh your system's icon cache using the following command:
1
sudo update-icon-caches /usr/share/icons/*
Copied!
For more information about creating and hinting icons, check out the Human Interface Guidelines​
Translations
Packaging
Last modified 2mo ago
Export as PDF
Copy link