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.
Before you start
Section titled “Before you start”- 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.
1. Find your current icon configuration
Section titled “1. Find your current icon configuration”Open your parent theme’s folder and locate:
wp-content/themes/your-parent-theme/css/fontello/config.jsonFor example, RT-Theme 18 uses:
wp-content/themes/rttheme18/css/fontello/config.jsonDownload 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.
2. Import the set into Fontello
Section titled “2. Import the set into Fontello”- Open fontello.com.
- Open the settings menu (wrench icon) → Import, then select your
config.json. You can also drag the file onto the Fontello page. - Check that the theme’s existing icons appear selected before adding anything.
Fontello’s project import guide explains how to reopen a saved configuration.
3. Add your icons
Section titled “3. Add your icons”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.
4. Download and upload the complete set
Section titled “4. Download and upload the complete set”- Choose Download webfont in Fontello.
- Extract the downloaded ZIP on your computer.
- Rename the extracted package folder, typically named
fontello-…, tofontello. This should be the folder containingconfig.json,css/, andfont/. - Upload that whole folder into the active child theme’s
css/folder. Createcss/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 filesCheck 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.
5. Refresh and check the result
Section titled “5. Refresh and check the result”- 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.
- Open a theme icon picker and select one of your new icons.
- Save the page or setting, then view it on your website.
- 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.
Troubleshooting
Section titled “Troubleshooting”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.