Import and Export Kit Icon Lists
Keep your Kit's icons in a file. Export a list, edit it, share it with your team, and import it into any Kit you've built.
Before You Start
You can only use icon lists with Kits where you hand-pick icons using "By Icon." Kits built "By Style" or with the "Full Library" don't have the Import/Export option, and that includes every Free Library Kit.
Where to Find the Import/Export options
On your Kit's Icons tab, the line at the top reads "Only your hand-picked icons." followed by two links:
- Import list opens the import window.
- Export list downloads your Kit's icons. It shows once your Kit has at least one icon and your plan includes Pro downloads.
You'll also find Export Icon List on the Kit's Download tab and Import Icons on its Settings tab. They do the same thing.
Export a List
Export list downloads a zip named after your Kit (e.g. my-kit-icons.zip). Inside is one .csv list for each family and style your Kit uses:
my-kit-icons.zip ├── my-kit-classic-solid.csv ├── my-kit-sharp-light.csv └── my-kit-classic-brands.csv
Each line of a list is one icon, written the way you'd use an icon: its family, its style and its icon name.
fa-classic fa-solid fa-house fa-classic fa-solid fa-user
Brands icons don't have a family, so they're written with just fa-brands:
fa-brands fa-github fa-brands fa-figma
Exports include Font Awesome icons only. Icons you've uploaded aren't in the list, and import can't add them.
Import a List
Select Import list, then drop your files in the import window or browse to them. You can import:
- The zip you exported, as it is. No need to unzip it.
- One or more
.csvor.txtlists. - Any mix of zips and lists, all at once.
You can type icons straight into the text box.
The import window checks every icon and shows what it found for each family and style. Icon names it couldn't find and lines it couldn't read are listed separately, since each needs a different fix. Select Add Icons to Kit (it shows the count, like "Add 12 Icons to Kit") to add everything it found to your Kit in one go. When it's done, a Success! window shows how many icons were added and lists anything that wasn't. Select Import More Icons to go back and fix those lines, then import them again.
Import only ever adds icons. Icons already in your Kit stay put, even if they're not in your list, and an icon that's already there isn't added twice.
Pro+ Icons
Pro+ families and styles (like Etch, Thumbprint and Vellum) need a plan with Pro+. Without one, lines in those styles are marked Needs Pro+. and aren't added.
Import Requirements
Exported Lists Are Ready to Import
Every list in an export is already named and written the right way. If you haven't changed it, there's nothing to do. Import the zip as is.
The same rules apply whether you import a file, a zip or pasted text.
You can import up to 5,000 icons at a time. If your list has more, split it and import it in parts.
Line Format
- Each line must be one icon.
- Write each icon as its family, style and icon name, in that order:
fa-classic fa-solid fa-house. - Brands icons must be
fa-brandsand the icon name:fa-brands fa-github.
| Line | Result |
|---|---|
fa-classic fa-solid fa-house |
✅ Classic Solid house |
fa-sharp fa-light fa-house |
✅ Sharp Light house |
fa-sharp-duotone fa-solid fa-house |
✅ Sharp Duotone Solid house |
fa-brands fa-github |
✅ Brands github |
house |
✅ Uses the family and style in the file name |
fa-house |
✅ Same as house |
fa-solid fa-house |
✅ Classic Solid house. A style on its own is read as Classic |
fa-classic fa-house |
✅ Classic Solid house. A family on its own uses Solid, or its only style |
fa-semibold fa-house |
❌ No family. Write it like fa-classic fa-solid fa-house. |
fas fa-house, fab fa-github |
❌ Short prefixes like fas or fab aren't read. |
fa-solid fa-classic fa-house |
❌ The family goes before the style, like fa-classic fa-solid fa-house. |
fa-sharp fa-semibold fa-dog |
❌ Sharp has no Semibold style. |
fa-classic fa-brands fa-github |
❌ Brands lines have no family. Write them like fa-brands fa-github. |
fa-classic fa-solid fa-house fa-spin |
❌ Extra classes aren't read. |
fa-classic fa-solid house |
❌ The icon name needs fa- in front, like fa-classic fa-solid fa-house. |
A line that doesn't match is listed with the reason, and the rest of the list still imports.
CSV and TXT Files
All Icon names must be only letters, numbers and dashes, up to 64 characters.
.csv- Each icon must be on its own row, in column A.
- The family, style and icon name must be together in that one cell, separated by spaces:
fa-classic fa-solid fa-house. - Do not split an icon across multiple columns.
fa-classic,fa-solidandfa-housein three separate columns (e.g. A, B, C) are read as three separate entries, not one icon.
.txt- Each icon must be on its own line.
- The family, style and icon name must be together on that line, separated by spaces:
fa-classic fa-solid fa-house.
Lines with Only an Icon Name
It's best to write each line as an icon's family, style and icon name, like fa-classic fa-solid fa-house. If a line has only an icon name, like house:
- In a file: the file's name must end with the family and style, like
classic-solid.csv. - In pasted text: the family and style must be picked in the import window.
| File name | Icon-name-only lines go to |
|---|---|
classic-solid.csv |
✅ Classic Solid |
sharp-light.csv |
✅ Sharp Light |
my-kit-duotone-regular.csv |
✅ Duotone Regular |
my-kit-classic-brands.csv |
✅ Brands |
icons.csv |
❌ Rejected. Rename the file or add a family and style to each line |
Files You Can Import
| What | Accepted | Not accepted |
|---|---|---|
| File types | .csv, .txt, .zip |
Anything else, like .xlsx, .json or .pdf |
| Inside a zip | .csv and .txt lists, in any folder |
Any other file, like a README or a spreadsheet |
| Files your computer adds | __MACOSX, .DS_Store, Thumbs.db and the like are skipped |
|
| Zips | Ordinary zips | Password-protected or damaged zips |
Limits
| Limit | Most you can import |
|---|---|
| Size of each file you pick | 2 MB. A zip counts at its download size |
| Size of each list in a zip | 1 MB |
| Lists in one import | 37, one for each family and style in Font Awesome, zipped or not |
| Icons in one import | 5,000 |
If you go over any of these limits, split your list and import it in parts.
Large Kits
If an import would take your Kit over 15,000 icons, you'll see a warning first. Large Kits take longer to save, sometimes over a minute, and load more slowly on your website. You can still add them, but your site will be faster if you import only the styles you use, or split your icons across more than one Kit.
When Something Goes Wrong
If there's a problem with a file, the message tells you which one. In the messages below, {file} stands for your file's name, {list} for a list inside a zip, and {extra file} for any other file in a zip. A problem with one file doesn't stop the rest from importing.
| Message | What to do |
|---|---|
| {file}: Only .csv, .txt or .zip files can be imported. | Save the list as .csv or .txt. |
| {file} has {extra file} in it. A zip can only contain .csv or .txt icon lists. | Take the other files out of the zip and zip it again, or unzip it and pick the lists. |
| No icon lists were found in {file}. Check you picked the right zip. | The zip has no .csv or .txt lists, or they're empty. |
| We couldn't open {file}. It may be damaged or password-protected. | Export it again, or zip the lists again without a password. |
| We couldn't read {file}. Please try again. | Pick the file again. |
| {file} is over 2 MB. | Split the list into smaller files and import them in parts. See Limits. |
| {list} in {file} is over 1 MB. | Split the list into smaller files and import them in parts. See Limits. |
| That's more than 37 lists, one for each family and style. | Import fewer lists at a time. |
| That's more than 5,000 icon names. | Split the list and import it in parts. |
| This file's name doesn't say which family and style. | Name it like classic-solid.csv, or write each line as fa-classic fa-solid fa-house. Lines that have a family and style still import. |
| A reason heading, like Short Prefix, Missing Family or Style Before Family | Fix the line to match the line format. Lines from files whose names don't give a family and style are listed under Other Lines. The rest of the file still imports. |
| Not an Icon Name | Icon names must use only letters, numbers and dashes. |
| This list doesn't look like Font Awesome icon names, so we stopped checking it. | Most icon names in the list didn't match. Check the file is an icon list. You can still add the icons matched so far. |
| Not Found | The icon doesn't exist in your Kit's version of Font Awesome, in that family and style. Check the spelling, or the family and style. |
| Needs Pro+. | The line is in a Pro+ family or style. Upgrade to a plan with Pro+ to add it, or remove the line. |
| The server is busy. Try again in a minute. | Wait a minute and try again. You can still add the icons matched so far. |
| Sorry, we couldn't check all of those names. Please try again. | Import the list again. Lines already matched still show, and you can add them. |