Appearance
Are you an LLM? You can read better optimized documentation at /contribute/icons/metadata-conventions/tag-guide.md for this page in Markdown format
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.
email
Do
Lowercase tags match the style used across the icon library.
Email
Don't
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.
search
Do
This is short, common, and easy to find.
searching through files & folders
Don't
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.
blood type
Do
The phrase is clearer than either word on its own.
blood type medical label
Don't
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.
email
Do
This helps users find mail icons using a common synonym.
electronic postal message delivery
Don't
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.
message filter
Do
This adds a related concept for mail-search without duplicating the name.
mail search
Don't
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.
event
Do
This points to a specific idea users might search for.
icon
Don't
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.
emergency room
Do
This is relevant for an icon that marks emergency room locations.
doctor nurse pharmacy
Don't
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.
depleted
Do
This distinguishes battery-low from other battery icons.
charged
Don't
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.
typography
Do
This matches existing text-formatting icons and keeps related icons together in search.
fontography
Don't
Inventing a new term makes the icon harder to find and less consistent with related metadata.