Skip to content
Recipes

Adding custom font icons

RT-Theme 18, RT-Theme 19, RT-Theme 20, Nixe, BusinessLounge, NaturaLife, and AVA include a font-based icon set. You can add icons from Fontello or import your own SVG artwork, then select the new icons in the theme’s icon picker.

The key is to extend your theme’s existing icon set. Starting with an empty set can remove icons already used by your website.

  • Use an active child theme. If you need to create one, follow the WordPress child-theme guide. If your theme package includes a child theme, you can use that.
  • Back up any existing css/fontello/ folder in the child theme before replacing it.
  • Have access to your theme files through your hosting file manager or SFTP. You will upload extracted files, rather than install a ZIP through WordPress.

If you are switching from the parent theme to a child theme, save your current theme settings first. Some RT-Themes use separate Customizer settings for the child theme; check your theme’s documentation for exporting and importing them.

Open your parent theme’s folder and locate:

wp-content/themes/your-parent-theme/css/fontello/config.json

For example, RT-Theme 18 uses:

wp-content/themes/rttheme18/css/fontello/config.json

Download a copy of config.json to your computer. The parent-theme folder name differs between themes, so use the folder installed on your site.

Already added custom icons? Use css/fontello/config.json from your active child theme instead, so your next export includes your previous additions.

  1. Open fontello.com.
  2. Open the settings menu (wrench icon) → Import, then select your config.json. You can also drag the file onto the Fontello page.
  3. Check that the theme’s existing icons appear selected before adding anything.

Fontello’s project import guide explains how to reopen a saved configuration.

Click additional icons in Fontello’s collections to select them. Keep the existing icons selected.

To add your own artwork, drag an SVG file into the Custom Icons area and select the imported icon. Font icons use a single color: prepare simple filled shapes, convert strokes to paths, and combine the artwork into a compound path. For preparation details, see Fontello’s custom SVG guide.

Keep the imported font name, CSS class prefix, and existing icon names and character codes unchanged. These connect the font to icons already used by the theme. Give each new icon a distinct name in Edit Names, and avoid assigning it a code already used by another icon in Edit Codes.

  1. Choose Download webfont in Fontello.
  2. Extract the downloaded ZIP on your computer.
  3. Rename the extracted package folder, typically named fontello-…, to fontello. This should be the folder containing config.json, css/, and font/.
  4. Upload that whole folder into the active child theme’s css/ folder. Create css/ if it does not exist. If you are updating an existing custom set, replace its files with the new package after backing it up.

The resulting structure should look like this:

wp-content/themes/your-child-theme/
└── css/
└── fontello/
├── config.json
├── css/
│ └── fontello.css
├── font/
│ └── … generated font files
└── … other package files

Check that you have css/fontello/css/fontello.css, rather than an extra nested folder such as css/fontello/fontello-…/css/fontello.css. Upload both the CSS and font files from the same download.

Keep the downloaded ZIP and its config.json for future changes. Do not replace the parent theme’s files: an update could overwrite them.

  1. Reload your WordPress admin page. If it still shows the old set, force a refresh with Ctrl + F5 on Windows or Cmd + Shift + R in Chrome or Firefox on macOS. Alternatively, clear your browser’s cached files.
  2. Open a theme icon picker and select one of your new icons.
  3. Save the page or setting, then view it on your website.
  4. Check an existing icon too, to confirm the original set still works.

If the public page still shows the old icons, clear any site, optimization-plugin, or CDN cache serving those files. This recipe extends the theme’s own icon picker; a page builder’s separate icon library may use a different import process.

The new icons are missing from the picker. Confirm the child theme is active, the upload is in that child theme, and the folder structure matches the example. Refresh the admin page after clearing the browser cache.

An icon appears as a blank square or the wrong symbol. Upload the complete package again so its CSS and font files match, then clear caches. Confirm you kept the imported font name, prefix, and existing character codes. If only a custom SVG fails, simplify its paths and preview it in the downloaded demo.html before uploading again.

Existing icons disappeared. Reimport your backed-up configuration, leave the original icons selected, add your new icons, and generate the package again.

Icons work in the admin area but fail on the website. Check the public page’s cache first. If the issue persists, use your browser’s developer tools to check whether font requests fail. Missing files, blocked cross-domain requests, or HTTP font URLs on an HTTPS page need to be corrected in the file location or hosting/CDN configuration.

To undo the change, restore your backed-up child-theme css/fontello/ folder. If this was your first custom set, remove only the folder you added, then clear caches and check that the theme’s original icons return.