Naming Convention


The foundation of the naming convention in Iconoir is:



Contains one or more objects.


It's often an additional and unique element added as a secondary object (-minus, -plus, -warning).


A shape used as a container for the object (-square, -circle). If a shape is directly part of an object, it's not considered a container.

* You could notice a difference between icons such as user-minus and minus-square. The second one looks different because in this case the minus symbol is an [Object], followed by the [Container].


An optional rule is regarding icons style. Iconoir is actually offering Regular and Solid icons. With the latter, icons names end with -solid. An example here:

  • Regular: check-circle
  • Solid: check-circle-solid

Object-Oriented Naming

Exceptions apart, icons follow an object-oriented naming and should not embed actions in their names.


  • user-minus is correct.
  • remove-user would be wrong.

Physical Actions

Icons that represent a physical action or movement can embed that action in their name.


  • walking, running, vehicle-fast, crane-lifting are correct.

Most-Used Modifiers and Shapes


-plus, -minus, -warning, -check, -xmark, -tag, -ban, -slash

  • -plus-in and minus-in: Differently from -plus and -minus, these are used when the icon has a bigger plus or minus icon in the center or inside the main object.
  • -no-access: It's regularly used when the icon has a restrict symbol in a corner.


-square, -circle


If you spot an icon that is not following any of the rules, please open a new issue on GitHub.

Read it on GitHub
If you prefer, you can take a look at our documentation on our GitHub repository.
Iconoir Logo
Parts of this content are ©2020-2024 by individual Iconoir contributors. Content available under a MIT License.