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:

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:

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

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.

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:

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.
    No results