Font-Awesome README

The project's README from github.com/FortAwesome/Font-Awesome. As one markdown file: README.md.

Font Awesome Free

Version 7

Font Awesome is the Internet's icon library and toolkit, used by millions of designers, developers, and content creators.

Documentation

Learn how to get started with Font Awesome and then dive deeper into other and advanced topics:

Docs for version 7

Where did Font Awesome 6, 5, 4 (or 3) go?

Now that Font Awesome 7 has been released we are marking version 6 as Long Term Support (LTS). Version 6 will get critical bug fixes only. Version 3, 4, and 5 are now end-of-life and we don't plan on releasing any further versions of these.

You can see a complete list of versions on our Versions page.

Change log

The change log for releases is now available directly on our site.

Looking for older versions of Font Awesome? Check the releases.

Upgrading

From time-to-time we'll have special upgrading instructions from one version to the next.

Code of conduct

We will behave ourselves if you behave yourselves. For more details see our CODE_OF_CONDUCT.md.

Contributing

Please read through our contributing guidelines. Included are directions for opening issues.

Versioning

Font Awesome will be maintained under the Semantic Versioning guidelines as much as possible. Releases will be numbered with the following format:

<major>.<minor>.<patch>

For more information on SemVer, please visit https://semver.org.

The major version "7" is part of an umbrella release. It includes many different types of files and technologies. Therefore we deviate from normal SemVer in the following ways:

License

Font Awesome Free is free, open source, and GPL friendly. You can use it for commercial projects, open source projects, or really almost whatever you want.

Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font Awesome Free files already contain embedded comments with sufficient attribution, so you shouldn't need to do anything additional when using these files normally.

We've kept attribution comments terse, so we ask that you do not actively work to remove them from files, especially code. They're a great way for folks to learn about Font Awesome.

Team

https://github.com/orgs/FortAwesome/people

Font-Awesome (FortAwesome/Font-Awesome)

icons
Searching Database…

What is this?Font Awesome is an icon toolkit that ships icons as SVG, icon fonts, and CSS, used by millions of designers and developers to add scalable icons to websites and apps.
Is this a framework, or just a set of icon files I drop into my project?It's an icon toolkit/library, not a framework — you include its SVG, font, or CSS files (or the npm package) and reference icons with CSS classes rather than building an application around it.
How do I add Font Awesome to my site?Follow the getting-started guide in the official docs, which covers loading it via CDN, installing the npm package, or downloading the kit and referencing icon classes in your HTML/CSS.
Do I need any build tools or frameworks to use it?No specific build tools are required — it works as plain CSS/webfont/SVG assets you can drop into any web project.
Are all icons free, and are older versions still maintained?The free download only includes a subset of icons and styles (more is available in paid Pro); version 6 is now Long Term Support for critical fixes only, and versions 3, 4, and 5 are end-of-life with no further releases planned.
What's the difference between Font Awesome Free and Pro?Free includes a limited set of icons and styles under open licenses (CC BY, SIL OFL, MIT), while the paid Pro tier unlocks the full icon library, more styles, and additional formats.
How does Font Awesome handle versioning?It follows Semantic Versioning with the rule that minor and patch releases never remove icons, patches never intentionally break backward compatibility, and breaking changes are documented in UPGRADING.md.
Can I keep using Font Awesome 5 or 4?Those versions are end-of-life and will not receive further updates; only version 6 (LTS, critical fixes only) and the current version 7 are actively maintained.
Size
158.8 MB
Stars
77K
Age
14y
Commits · 90 Days