# Font Awesome — card for AI agents

Icon toolkit with a free set (CC BY 4.0), Pro plans, a GraphQL API and official agent skills.

Category: Icons · maker Fonticons, Inc. · checked 2026-10-27

## Price
- Price: Free tier
- Free tier: Free icon set and public GraphQL metadata.
- Paid from $10/month
- Usage price: Pro $120/year after 30 Apr 2025; Pro+ $150/year (official blog).

## License
Free: icons CC BY 4.0, fonts SIL OFL 1.1, code MIT; Pro: commercial license — https://github.com/FortAwesome/Font-Awesome/blob/7.x/LICENSE.txt

- commercial: **yes** (Commercial use OK)
  > You can use it for commercial projects, open source projects, or really almost whatever you want.
  (https://fontawesome.com/license/free)
- attribution: **required** (Credit required)
  > Attribution is required by MIT, SIL OFL, and CC BY licenses.
  (https://github.com/FortAwesome/Font-Awesome/blob/7.x/LICENSE.txt)
- in app: **yes** (Can ship inside your app)
  > You can use it for commercial projects, open source projects, or really almost whatever you want.
  (https://github.com/FortAwesome/Font-Awesome/blob/7.x/LICENSE.txt)

## Rules to follow
- Keep the attribution comments in Font Awesome Free files.
- Treat brand icons as trademarks of their respective owners.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- npm @fortawesome/fontawesome-free; GraphQL API at https://api.fontawesome.com (public metadata needs no token); fa CLI and agent skills via npx skills add FortAwesome/fontawesome-agent-tools. (sign-in: none)
- Formats: svg, js
- Not allowed: Do not remove the embedded attribution comments, especially from code
- Not allowed: Brand icons are trademarks of their owners; use them only to represent that brand

## React (official example, https://docs.fontawesome.com/web/use-with/react/add-icons)

```
npm i --save @fortawesome/fontawesome-svg-core
npm i --save @fortawesome/free-solid-svg-icons
npm i --save @fortawesome/react-fontawesome@latest

import { createRoot } from 'react-dom/client'
import { FontAwesomeIcon } from '@fortawesome/react-fontawesome'
import { faEnvelope } from '@fortawesome/free-solid-svg-icons'

const element = <FontAwesomeIcon icon={faEnvelope} />

createRoot(document.body).render(element)
```

## How to connect
- Public API
- API docs: https://docs.fontawesome.com/apis
- API limits: Public metadata needs no token; Kits and account data need a token. SVG downloads via the fa CLI only on download-enabled plans (Pro, Pro+).
- npm: `npm install @fortawesome/fontawesome-free`
- Repository: https://github.com/FortAwesome/Font-Awesome
- Website: https://fontawesome.com

## Notes
No official MCP; official agent Skills and fa CLI: npx skills add FortAwesome/fontawesome-agent-tools (Sep 2026).

## Numbers (AgentGid data)
- Gid Score: 61
- GitHub stars: 77,045
- Downloads last week: 3,314,122
- Used in 17 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- Font Awesome (Icons). Icon toolkit with a free set (CC BY 4.0), Pro plans, a GraphQL API and official agent skills. Price: free tier; commercial use OK; credit required.
  Connect: API docs https://docs.fontawesome.com/apis; npm @fortawesome/fontawesome-free. Limits: Public metadata needs no token; Kits and account data need a token. SVG downloads via the fa CLI only on download-enabled plans (Pro, Pro+).
  Get files: npm @fortawesome/fontawesome-free; GraphQL API at https://api.fontawesome.com (public metadata needs no token); fa CLI and agent skills via npx skills add FortAwesome/fontawesome-agent-tools (svg, js).
  Not allowed: Do not remove the embedded attribution comments, especially from code
  Not allowed: Brand icons are trademarks of their owners; use them only to represent that brand
  Rule: Keep the attribution comments in Font Awesome Free files.
  Rule: Treat brand icons as trademarks of their respective owners.
  License: https://github.com/FortAwesome/Font-Awesome/blob/7.x/LICENSE.txt (checked 2026-10-27; details: https://agentgid.com/assets/font-awesome/)
```

Not verified: fontawesome.com/plans and /license/free not readable; current 2026 prices unconfirmed.

## Links
- AgentGid page: https://agentgid.com/assets/font-awesome/
- Is it free for commercial use? https://agentgid.com/assets/font-awesome/commercial-use/
- Source: https://github.com/FortAwesome/Font-Awesome/blob/7.x/LICENSE.txt
- Source: https://docs.fontawesome.com/apis/graphql
- Source: https://docs.fontawesome.com/apis
- Source: https://blog.fontawesome.com/font-awesome-7-is-on-the-menu/
- Source: https://blog.fontawesome.com/font-awesome-ai-agent-tools/


## Font Awesome: icons for sites, with a free set

Font Awesome is a large collection of icons, such as a house, a cart or an envelope, that you add to a web page with one short tag. The free part has solid and outline icons plus logos of many brands, and you may use it in paid products. More styles and extra icons come with a paid Pro plan.

### Where to use it
- Icons on any web page: Put a menu, a contact block or a feature list on a plain site with one short tag per icon. The icon takes the size and color of the text around it.
- Icons in a React app: Import only the icons a screen needs, such as an envelope on a Contact button, so the app stays small. The free icons need no account or key.
- Links to your social pages: Use the free brand icons to point to your company page on a social network or app store. Use each logo only to stand for that brand.
- Icons on WordPress and Squarespace sites: Add icons to a site made with a website builder, using the official guides for WordPress and Squarespace.
- Look up icon names in code: Ask the public icon catalog which icons and versions exist, without a key, for example to check a name before your assistant uses it.
- File and status icons in a dashboard: Mark rows with a PDF file, an upload cloud, a lock or a truck, so people scan a list of orders or files faster. (idea, not from the official pages)

### How to start
- For a plain site, copy the css and webfonts folders from the free download or package into your site, and link fontawesome.css plus one file per style you use.

```
npm i --save @fortawesome/fontawesome-free
```

- In React, install the component, the core and the free icon packages you need.

```
npm i --save @fortawesome/react-fontawesome@latest
npm i --save @fortawesome/fontawesome-svg-core
npm i --save @fortawesome/free-solid-svg-icons
npm i --save @fortawesome/free-regular-svg-icons
```

- Add an icon by its style and name as classes, for example fa-solid fa-user.

```
<i class="fa-solid fa-user"></i>
<i class="fa-regular fa-user"></i>
```


### License
The free icons may be used in personal and paid products. Credit is required, but the comments already inside the files count, so do not remove them. Brand logos may only stand for their own brand.

### Good to know
- Only part of the icons and styles is free. Light, Thin, Duotone, Sharp and other styles need a paid Pro or Pro+ plan.
- The quickest setup, a Kit, needs a free account and counts page views, also on free accounts. Copying the files to your own site avoids both.
- The all-in-one style file and the full package are very large. Link only the style files you use.
- Brand logos belong to their companies. They are fine for links to that company, not as decoration or your own logo.
- Even small updates inside version 7 may change how an icon looks or break old code, so pin the exact version.

Checked 2026-11-09 against: https://fontawesome.com/, https://fontawesome.com/license/free, https://fontawesome.com/plans, https://github.com/FortAwesome/Font-Awesome/blob/7.x/LICENSE.txt, https://github.com/FortAwesome/Font-Awesome/blob/7.x/README.md, https://registry.npmjs.org/@fortawesome/fontawesome-free/7.3.1, https://docs.fontawesome.com/llms.txt, https://docs.fontawesome.com/web/setup/get-started.md, https://docs.fontawesome.com/web/setup/use-kit.md, https://docs.fontawesome.com/web/setup/packages.md, https://docs.fontawesome.com/web/setup/host-yourself/webfonts.md, https://docs.fontawesome.com/web/setup/host-yourself/svg-js.md, https://docs.fontawesome.com/web/add-icons/how-to.md, https://docs.fontawesome.com/web/use-with/react.md, https://docs.fontawesome.com/web/use-with/react/add-icons.md, https://docs.fontawesome.com/web/use-with/ai-agent-tools.md, https://docs.fontawesome.com/web/use-with/fa-cli.md, https://docs.fontawesome.com/web/dig-deeper/accessibility.md, https://docs.fontawesome.com/apis/graphql.md, https://blog.fontawesome.com/font-awesome-ai-agent-tools/

### Mistakes to avoid
- Don't: <i class="fa-light fa-user"></i> or fa-thin, fa-duotone, fa-sharp with the free files → Do: With Font Awesome Free use fa-solid, fa-regular (fewer icons) or fa-brands (The other styles are Pro only, so with the free files the icon shows nothing; the free 7.3.1 package has 2001 solid, 273 regular and 609 brand icon files (our count).)
- Don't: Linking all.css or importing whole styles (library.add(fas, far, fab)) for a few icons → Do: Link fontawesome.css plus the style files you use; in React import single icons like faEnvelope (The full files and packages are large and slow pages down.)
- Don't: Copying only the css folder to the site → Do: Copy both css and webfonts, keeping them side by side as in the package (The CSS points to the font files by a relative path; without them every icon is an empty box.)
- Don't: Stripping the license comment from the top of the CSS and SVG files while minifying → Do: Keep the /*! Font Awesome Free … License … */ header (most minifiers keep /*! comments) (The comment is the required credit; the license asks not to remove it.)
- Don't: <button><i class="fa-solid fa-trash"></i></button> with no text → Do: <button aria-label="Delete"><i class="fa-solid fa-trash"></i></button> (Icons are hidden from screen readers, so an icon-only button needs a label on the button.)

### Questions
- Can I use the free icons in a paid app or a client site? Yes. Font Awesome Free may be used for commercial projects; the icons are CC BY 4.0, the fonts SIL OFL 1.1 and the code MIT.
- Do I have to show a credit? Credit is required by the licenses, but the comments already in the downloaded files are enough. Do not strip them out.
- Do I need an account? Not for the free packages or downloaded files. A Kit, the hosted one-line setup, is made in your account on fontawesome.com.
- Will screen readers read the icons? No, they are hidden by default. Add an aria-label when an icon carries meaning, such as an icon-only button.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
