Iconography in Design Systems
Create icons that stay consistent, legible, and aligned with the visual language of your design system.
Icons look simple, yet they carry a high amount of responsibility. They guide users, communicate actions, and support navigation in tight spaces where words do not fit. A well-defined iconography standard helps teams avoid visual noise and keep interfaces predictable.
Clear rules around grids, size, stroke, and metaphor ensure that every icon feels like part of the same family. When the shapes, corner treatments, and visual weight are consistent, icons become easier to scan and quicker to recognize. This also reduces cognitive load for users across features and platforms.
Standardizing naming, grouping, and file structure keeps the library manageable as it grows. Designers can confidently add new icons and avoid duplicates, while engineers benefit from stable assets and predictable formats. With a shared approach to structure and style, iconography becomes a reliable tool rather than a point of friction.
Icon size is defined by the outer frame, such as 16, 24, or 32 pixels. The frame sets clear boundaries for drawing and keeps proportions predictable across the entire icon set. Using fixed frame sizes also helps designers place
Inside the frame, the grid guides how shapes are positioned. The grid separates the live drawing area from the trim area, which provides a bit of space around the icon so shapes do not feel cramped. Smaller frames rely on tighter trim and simpler forms, while larger frames allow more room for detail. Pixel snapping supports this structure by keeping points aligned to whole pixels, which helps icons render sharply.
Smaller frames have tighter trim and thinner strokes, while larger frames increase both to keep the visual weight balanced. For example, a 16 pixel icon often uses a 1 pixel stroke, while a 24 pixel icon uses a 1.5 pixel stroke to stay clear at its scale. Larger icons may increase to 2 or 3 pixel strokes to maintain the same visual weight. Treating each size as its own design task avoids distortions that appear when icons are simply scaled up or down.[1]
Pro Tip: Keep corner rounding consistent across icons. Even small differences can make shapes look uneven at smaller sizes.
Metaphors determine how quickly users understand what an icon represents. The most reliable
Clarity matters more than novelty. When icons rely on uncommon or ambiguous symbols, users may hesitate or misunderstand the action. Selecting metaphors that match common patterns across the web helps keep the interface predictable. This is especially important in dense
Using universal metaphors also supports consistency within the icon set itself. When every icon follows the same visual language and represents its concept with a clear, simple form, the system becomes easier to learn and more comfortable to use.[2]
Pro Tip: If a metaphor needs explanation, it is likely not the right choice for an icon.
Simplicity is essential for
Excessive detail tends to blur or disappear when an icon is viewed at small scales. Fine lines, inner patterns, or unnecessary angles can become hard to read and may create uneven visual weight within the set. Minimizing detail keeps shapes crisp and helps icons stay legible across different screen densities.
Keeping forms simple also reinforces consistency. When all icons follow the same level of refinement, they appear more cohesive as a system. This makes it easier for users to scan interfaces and easier for teams to expand the icon set without constant stylistic adjustments.
Pro Tip: If removing a detail does not change the meaning of the icon, leave it out.
Some systems support more than one icon style, such as outlined, filled, or duo-tone versions. Each variant serves a different purpose. Outlined
To maintain consistency, each style must follow the same structural rules. Stroke alignment, corner treatments, trim areas, and overall proportions should match across variants. When these rules stay consistent, switching between outlined and filled versions feels intentional rather than disruptive.
Using variants responsibly also supports accessibility. Filled icons offer stronger contrast in compact spaces, while outlined versions pair well with text-heavy
Pro Tip: Use filled icons sparingly. When everything is emphasized, nothing stands out.
Different densities also affect how much detail an icon can safely contain. Smaller sizes work best with simplified shapes because thin lines or small gaps may disappear on high-density or low-density displays. Larger sizes can support slightly more detail, but they must still follow the same structural rules to remain part of the same system.
Using scalable formats such as SVG helps icons stay crisp without generating multiple raster files. These files preserve vector shapes and allow icons to adapt to different screen densities without losing sharpness. They also make it easier for teams to maintain consistent behavior across platforms.[4]
Pro Tip: Use SVG for handoff. It keeps icons sharp across densities and reduces maintenance work.
Before an
After flattening, designers apply a color token such as content primary. This token keeps the icon responsive to theme changes. Once the color is applied, the icon is placed inside a frame that matches its intended size, for example 16 or 24
Pro Tip: Always flatten the icon before creating a component. It prevents broken overrides later.
Organizing an icon library starts with grouping
The internal structure of each icon is crucial for keeping overrides intact when swapping icons in
Keeping identical layer names, order, and structure across all icons prevents this problem and keeps the library stable.
Pro Tip: Use one flattened vector named exactly the same across all icons. Even a difference in letter case causes overrides to reset.
Clear naming helps teams find
Tagging adds another layer of findability. Tags capture all the different terms designers might use to locate an icon. A single icon can include tags like draw, pen, vector, or write, so any of these
Consistent naming and tagging also prevent duplicates. When teams follow the same patterns, they avoid creating multiple icons that represent the same concept. This reduces maintenance work and keeps the visual language aligned across products.
Pro Tip: Tag icons with both the action and the object, for example “edit,” “pencil,” and “write.”
When
Placing icons on the same baseline as the text helps both elements feel connected. Center alignment inside buttons or compact
Clear spacing between the icon and the text improves recognition. Many design systems place icons inside a container or use a spacing token so the gap stays consistent across components. This prevents icons from crowding the label or creating unexpected visual gaps. When spacing and alignment are consistent,
Pro Tip: Use semantic color tokens for icons so they adapt reliably across light and dark themes.
Accessible
Legibility is another important factor. Meaningful icons must remain clear at their intended size. Outlines should stay thick enough to be visible, and shapes should avoid unnecessary complexity that may
Accessible color choices help users with low vision or color blindness. Icons must meet
Pro Tip: Never rely on color alone to convey meaning. Pair status colors with a clear shape or symbol.
References
- A complete guide to iconography | DesignSystems.com
- Overview - Iconography - Atlassian Design System | Atlassian Design System





















