Tag guide
This guide shows how to write useful search tags for Lucide icons.
Tags help people find icons by concept, synonym, context, or common wording.
Use lowercase tags
Tags should always be lowercase.
Lowercase tags match the style used across the icon library.
Capitalized tags create inconsistent metadata without improving search.
Prefer short tags
Use one clear word when it is enough. Use multi-word tags when the phrase is clearer.
This is short, common, and easy to find.
This reads like a use case, not a tag.
Use multi-word tags when needed
Some ideas are only clear as a phrase. But keep those phrases short.
The phrase is clearer than either word on its own.
This combines several search concepts into one long tag.
Add synonyms and common wording
Tags can include words people are likely to search for, even if they are not in the icon name.
This helps users find mail icons using a common synonym.
This is unlikely search wording and adds noise.
Do not repeat the icon name
The icon name is already searchable. Tags should add other ways to find it.
This adds a related concept for mail-search without duplicating the name.
This repeats the icon name and does not improve discovery.
Avoid generic tags
Tags should describe the icon, not say that it is an icon.
This points to a specific idea users might search for.
Every entry is an icon, so this tag does not help anyone find the right one.
Keep tags relevant
Do not add loose terms just to make an icon appear in more searches.
This is relevant for an icon that marks emergency room locations.
These terms may be nearby concepts, but they do not all describe the same icon.
Match the specific variant
Related icons can share family terms, but variant tags should describe what is different.
This distinguishes battery-low from other battery icons.
This describes battery-full better than battery-low.
Use existing tags as a reference
Check similar icons before adding new tags. Reusing existing terms keeps search predictable.
This matches existing text-formatting icons and keeps related icons together in search.
Inventing a new term makes the icon harder to find and less consistent with related metadata.