• Classified Listing Docs
    • Classified Listing Plugin
    • Classified Listing All Addons
    • Classified Listing Mobile App
    • Classima Mobile APP
    • Listygo Mobile App
    • Homlisti Mobile App
  • Woocommerce Plugins Docs
    • ShopBuilder Elementor Addon
    • Woo Variation Swatches
    • Woo Variation Gallery
    • Zilly Mobile App
  • General Plugins Docs
    • The Post Grid
    • Testimonial Slider
    • Team Members
    • Food Menu
    • Review & Schema
    • Portfolio
    • Business Review
  • Our Plugins
    • The Post Grid
    • Classified Listing
    • ShopBuilder
    • Food Menu
    • Team
    • Portfolio
    • Testimonial Slider
    • Review & Schema
    • See All Plugins
×
  • Classified Listing Docs
    • Classified Listing Plugin
    • Classified Listing All Addons
    • Classified Listing Mobile App
    • Classima Mobile APP
    • Listygo Mobile App
    • Homlisti Mobile App
  • Woocommerce Plugins Docs
    • ShopBuilder Elementor Addon
    • Woo Variation Swatches
    • Woo Variation Gallery
    • Zilly Mobile App
  • General Plugins Docs
    • The Post Grid
    • Testimonial Slider
    • Team Members
    • Food Menu
    • Review & Schema
    • Portfolio
    • Business Review
  • Our Plugins
    • The Post Grid
    • Classified Listing
    • ShopBuilder
    • Food Menu
    • Team
    • Portfolio
    • Testimonial Slider
    • Review & Schema
    • See All Plugins

Getting Started

4
  • System Requirements
  • Installation
  • Permalink Settings
  • How to use(video)

Main Settings

15
  • Overview
  • General Settings
  • All Listings Page
  • Listing Details Page
  • Payments
  • Tax
  • Email
  • Account & Policy
  • Style
  • MISC Settings
  • Chat Settings Pro
  • Page Setup & Permalink
  • Tools
  • App Settings
  • Membership [Store addon] Pro

Email Settings

3
  • General Settings
  • Email Template
  • Video (How to Use)

Developer Docs

1
  • Developer Docs

Listing Management [Admin]

9
  • Admin End Ads View
  • Category
  • Locations
  • Listing Type
  • Pricing
  • Payment History
  • Export & Import Settings
  • Default Import [XML]
  • Stores [store addon]

AI Integration

5
  • Create Form with AI
  • Frontend AI Integration
  • AI Integration Settings
  • AI Semantic Search
  • AI Image Enhancement

MCP Integration

5
  • Overview
  • Install & Enable MCP Adapter Plugin
  • MCP Adapter Settings
  • Connect the Claude Desktop App
  • Test Your Connection

Radius Booking Integration

10
  • How to Use (Video)
  • Integration with Radius Booking
  • Radius Booking Field in Form Builder
  • Enable Radius Booking on Existing Listing
  • Payout Settings
  • Payout Request from Front End Dashboard
  • Payout Request on Admin Panel
  • Commission Overview — Admin Panel
  • My Account – Booking
  • Appointments – Admin Panel

Theming

4
  • Add theme support for plugin templates
  • Override Ad Submission Form
  • Override ad detail page
  • Theming

Payment

8
  • Checkout Option
  • Offline Payment
  • Paypal
  • Authorize.net [PRO]
  • Stripe [PRO]
  • WooCommerce [PRO]
  • Payfast [Addon]
  • Paystack [Addon]

REST API

54
  • Form Builder Image Sort REST API
  • Form Builder Image Delete REST API
  • Form Builder File Delete REST API
  • Form Builder File Upload REST API
  • Create Listing via Form Builder REST API
  • Email Store Owner REST API
  • Get Single Store REST API
  • Get Store Listings REST API
  • Get Stores REST API
  • Upload My Store Banner REST API
  • Upload My Store Logo REST API
  • My Store REST API
  • My Store REST API
  • Report Listing REST API
  • Update Subscription Payment Method API
  • Cancel Subscription REST API
  • Get Pricing Plans REST API
  • Get Single Payment / Order Details REST API
  • Get Payment History REST API
  • Get Checkout Data REST API
  • Create New Tag REST API
  • Change Order Status REST API
  • Manage Orders REST API
  • Mark Message as Read REST API
  • Chat Message REST API
  • Check Conversation by Listing REST API
  • Start New Conversation API
  • Get Conversation Messages API
  • My Chat List REST API
  • Toggle a favourite listing REST API
  • Get My Favourite Listings REST API
  • Upload My Profile Image REST API
  • Update My Account REST API
  • Get My Account Info REST API
  • Mark Listing as Sold REST API
  • Change Listing Status REST API
  • Renew Listing REST API
  • Delete My Listings REST API
  • Get My Listings REST API
  • Get Single Listing API
  • Create a listing API
  • User Sign Up REST API
  • Login REST API
  • Logout REST API
  • Account Delete REST API
  • Reset Password REST API
  • Contact REST API
  • Configuration API
  • Locations API
  • Categories API
  • Listing Types API
  • Email Seller API
  • Listings API
  • General

Code Snippets

18
  • Mask more digits
  • Change Business Hour Start and End Time
  • Add Price Unit
  • Trim zero from payment price
  • Show mark as sold listing in the search
  • Remove required attribute for phone field
  • Remove Price Type
  • Modify listing submission success message
  • Modify checkout form fields
  • Display listing image in media library
  • Change radius unit and distance
  • Change Price Type
  • Change Favourites to Favorites
  • Change Excerpt Limit
  • Change Currency Symbol
  • Change archive page listing column
  • Add New Price Type
  • Code Snippets

Elementor Addons

11
  • Elementor Addons
  • Listing Category
  • Listing Category Slider
  • All Location
  • Single Location
  • Listings
  • Listing Slider
  • Listing Store
  • Pricing Table
  • Search Form
  • Header Button

Filter Hooks

15
  • rtcl_countries_all_countries
  • rtcl_checkout_fields
  • Checkout
  • rtcl_my_account_endpoint
  • rtcl_account_menu_items
  • My Account
  • rtcl_listing_pricing_types
  • Listing Form
  • rtcl_social_profiles_list
  • rtcl_registration_redirect
  • rtcl_listing_seller_contact_form_data
  • rtcl_listing_query_meta_query
  • rtcl_get_base_location
  • General
  • Filter Hooks

WPML Addon

3
  • System Requirements
  • Location Translations
  • WPML Settings

Action Hooks

14
  • Email
  • rtcl_payment_receipt
  • rtcl_checkout_process_success
  • Checkout
  • rtcl_account_{$menu_key}_endpoint
  • My Account
  • rtcl_listing_form_before_category_retrieve
  • rtcl_listing_form_after_save_or_update
  • Listing Form
  • rtcl_new_user_created
  • rtcl_listing_loop_item
  • rtcl_after_author_meta
  • General
  • Action Hooks

AJAX Filter Builder

2
  • Add Filter Items
  • Filter Widget

Listing Management [Front End]

3
  • Front End View
  • Front End Submission
  • My Account Menu

Frequently Asked Questions (Faq’s)

29
  • Frequently Asked Questions(Faq’s)
  • Fix taxonomy page listing sorting issue
  • Disallow query string and specific URL [SEO]
  • Enable New Dashboard [Canvas]
  • Custom Fields for Listview
  • Custom Fields for Filter
  • Pay Per Ad
  • Admin Menu Access
  • How to change listing archive category description position
  • Category & Location Menu Link
  • Add Re-Captcha
  • Add Google Map
  • Rank Math SEO Settings
  • Enable Chat
  • Renew listing process
  • How to set Local Time for Business Hour
  • Enable WooCommerce Payment
  • Fix Custom Field Save Issue
  • Enable Mark as Sold
  • How to add Compare
  • How to clear plugin cache?
  • Change Archive Page Title
  • User don’t get Registration & Verification Email?
  • How to change custom fields order?
  • How to add Watermark
  • How to separate login and registration page?
  • How to hide contact information for non logged in users?
  • Enable Social Login
  • Enable User Registration

Shortcodes

9
  • Shortcodes
  • Categories Display
  • Checkout Page
  • Listing Submission Form
  • My Account Page
  • Store List
  • Location Wise Display
  • Category Wise Display
  • Listing Filter

Drag & Drop Form Builder (New)

14
  • How to add your own icon in the builder
  • Multi-Category Selection
  • Enable Form Builder
  • Form List
  • Add New Form
  • Preset Fields
  • Custom Fields
  • Single Listing Layout Builder New
  • Enable Multiple Forms
  • Enable Conditional Logic
  • Add Bulk Options Pro
  • Smart Dependency Pro
  • SEO-Friendly Slug Builder
  • Image Crop Feature

Gutenberg Block

10
  • Gutenberg Block
  • Listing Category
  • Listing Category Slider
  • All Location
  • Single Location
  • Listings
  • Listing Slider
  • Listing Search
  • Pricing Table
  • Stores
  • Home
  • Docs
  • Drag & Drop Form Builder (New)
  • How to add your own icon in the builder
View Categories

How to add your own icon in the builder

8 min read

0:00 / 8:21
  • View as Markdown Open this page as plain Markdown (opens in a new tab)
  • Open in ChatGPT Ask questions about this page (opens in a new tab)
  • Open in Claude Ask questions about this page (opens in a new tab)
  • Open in Google AI Studio Ask questions about this page (Google account required) (opens in a new tab)

The Form Builder icon picker (Icon Type → Icon → Choose icon) comes with the Classified Listing icon set. You can add your own icon pack to it, for example an icon font made with IcoMoon or Fontello, so your icons appear in the Icon Library next to the built-in ones and can be used on fields, field options and directories.

This guide walks you through it step by step. You only need basic PHP and CSS, and about 15 minutes.

How it works #

Two things have to happen for a custom icon to work:

  1. The picker has to know the icon’s CSS class. The list of icons in the picker comes from the rtcl_get_icon_class_list filter. You add your class names to that list.
  2. The browser has to load your icon CSS. The picker and your forms simply print <i class="your-icon-class"></i>. If your icon stylesheet is not loaded on that page, the icon shows up as an empty box.

So we will: (1) put the icon font files in a small plugin, (2) load the CSS in the admin and on the front end, and (3) add the class names to the filter.

What you need #

  • An icon font with a CSS file in which every icon has its own class, for example myicon-truck, myicon-bike.
  • FTP or file manager access to wp-content/plugins/.
  • Classified Listing active, with the Form Builder enabled.

Tip: Use a class prefix that nobody else uses, such as myicon- or your company name. Avoid rtcl-icon- and fa-, which are already used by Classified Listing and Font Awesome.


Step 1: Create a small plugin for your icons #

Keep your icons in their own plugin, not inside the Classified Listing folder. Plugin updates replace the Classified Listing folder, but your own plugin stays untouched. (A child theme’s functions.php also works, but a plugin keeps working if you change the theme.)

Create this folder structure:

wp-content/plugins/my-rtcl-icons/
├── my-rtcl-icons.php
└── assets/
    ├── my-icons.css
    └── fonts/
        ├── my-icons.woff2
        └── my-icons.woff

Copy the font files from your icon pack into assets/fonts/, and its stylesheet into assets/my-icons.css.

Step 2: Check the icon CSS #

Open assets/my-icons.css. It should look roughly like the example below. The two things to check are:

  • The url(...) paths point to the fonts/ folder relative to the CSS file.
  • There is one class per icon (.myicon-truck::before and so on).
@font-face {
	font-family: "my-icons";
	src: url("fonts/my-icons.woff2") format("woff2"),
	     url("fonts/my-icons.woff") format("woff");
	font-weight: normal;
	font-style: normal;
	font-display: block;
}

/* Shared style for every icon whose class starts with "myicon-". */
[class^="myicon-"],
[class*=" myicon-"] {
	font-family: "my-icons" !important;
	font-style: normal;
	font-weight: normal;
	line-height: 1;
	speak: never;
	-webkit-font-smoothing: antialiased;
	-moz-osx-font-smoothing: grayscale;
}

/* One rule per icon. The "content" codes come from your icon pack. */
.myicon-truck::before { content: "\e900"; }
.myicon-bike::before  { content: "\e901"; }
.myicon-house::before { content: "\e902"; }

Using SVG icons instead of a font? That works too, as long as each icon is a CSS class, for example a class that sets background-image or mask-image to your SVG and gives the element a width and height. The picker only cares about the class name.

Step 3: Write the plugin file #

Paste the code below into my-rtcl-icons.php. Then replace the class names in my_rtcl_icon_classes() with the ones from your CSS file.

<?php
/**
 * Plugin Name: My Classified Listing Icons
 * Description: Adds my own icon pack to the Classified Listing Form Builder icon picker.
 * Version:     1.0.0
 * Requires Plugins: classified-listing
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Stop if this file is opened directly.
}

/**
 * The CSS classes of my icons, exactly as they are written in my-icons.css
 * (without the leading dot).
 *
 * @return string[]
 */
function my_rtcl_icon_classes() {
	return [
		'myicon-truck',
		'myicon-bike',
		'myicon-house',
	];
}

/**
 * 1. Add my icons to the Form Builder icon picker.
 *
 * The filter receives the built-in icon list; we return it with our icons added.
 */
add_filter( 'rtcl_get_icon_class_list', function ( $icons ) {
	return array_merge( my_rtcl_icon_classes(), $icons );
} );

/**
 * Register the icon stylesheet once, for both the admin and the front end.
 */
function my_rtcl_register_icon_css() {
	wp_register_style(
		'my-rtcl-icons',
		plugin_dir_url( __FILE__ ) . 'assets/my-icons.css',
		[],
		'1.0.0' // Change this number whenever you update the icons, to clear browser caches.
	);
}

/**
 * 2. Load the icons in the admin: the Form Builder screen and the listing add / edit screens.
 */
add_action( 'admin_enqueue_scripts', function ( $hook ) {
	my_rtcl_register_icon_css();

	$screen          = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
	$is_form_builder = (bool) preg_match( '/_page_rtcl-fb$/', $hook );
	$is_listing_page = $screen && 'rtcl_listing' === $screen->post_type;

	if ( $is_form_builder || $is_listing_page ) {
		wp_enqueue_style( 'my-rtcl-icons' );
	}
} );

/**
 * 3. Load the icons on the front end, where the submit form, listings and
 *    directory list show them.
 */
add_action( 'wp_enqueue_scripts', function () {
	my_rtcl_register_icon_css();
	wp_enqueue_style( 'my-rtcl-icons' );
} );

What each part does:

PartWhat it does
my_rtcl_icon_classes()The one place where you list your icon classes. Add a line here for every new icon.
rtcl_get_icon_class_list filterAdds your classes to the list the picker shows. array_merge( mine, $icons ) puts your icons first; swap the two arguments to put them last.
admin_enqueue_scriptsLoads your CSS on the Form Builder screen (so the picker can draw the icons) and on the admin Add / Edit Listing screen (so the form there shows them).
wp_enqueue_scriptsLoads your CSS on the front end, so visitors see the icons in the listing submit form and wherever the chosen icon is displayed.

Step 4: Activate and test #

  1. Go to Plugins and activate My Classified Listing Icons.
  2. Open Classified Listing → Form Builder and edit a form.
  3. Click a field, then in Input Customization set Icon Type to Icon.
  4. Click Choose icon. The Icon Library opens. Type your prefix (for example myicon) in the search box: your icons appear.
  5. Click your icon, then Insert (or double-click the icon). Click Save Form.
  6. Open the listing submit page on the front end and check that the icon shows next to the field.

The name under each icon in the library comes from its class: myicon-truck is shown as “Myicon Truck”. Search also matches the class name, so searching truck or myicon both find it.


Optional: show only your own icons #

If you want the picker to show only your icon pack and hide the built-in icons, return your list instead of merging it:

add_filter( 'rtcl_get_icon_class_list', function ( $icons ) {
	return my_rtcl_icon_classes();
} );

Careful: fields that already use a built-in icon keep that icon on the front end, but you can no longer pick it again in the builder. Only do this on a new site, or after you have changed those fields.

Optional: icons that need two classes #

Some icon packs need two classes per icon, for example Font Awesome 6 uses fa-solid fa-truck. Add the full class string as one item, with a space in between:

function my_rtcl_icon_classes() {
	return [
		'fa-solid fa-truck',
		'fa-solid fa-motorcycle',
	];
}

Remember that the pack’s own CSS (here the Font Awesome stylesheet) must be loaded by your plugin as in Step 3. Classified Listing does not load Font Awesome on every page.


Troubleshooting #

ProblemCause and fix
My icons don’t appear in the Icon Library at all.The filter is not running. Check that the plugin is active and that there is no PHP error (turn on WP_DEBUG). Then reload the Form Builder page with a hard refresh (Ctrl/Cmd + Shift + R).
The tiles appear with the right names, but the icons are empty boxes.The CSS is not loaded, or its font paths are wrong. Open the browser DevTools → Network tab, reload, and look for my-icons.css and the .woff2 file. A 404 means the path in wp_register_style() or in the CSS url(...) is wrong.
Icons work in the builder but not on the front end.The wp_enqueue_scripts part is missing, or a caching / optimisation plugin is serving an old CSS bundle. Clear its cache.
Some icons look like a different icon or a square.The content code in your CSS does not match the font. Re-export the CSS from your icon tool together with the font files.
After updating the icon pack, the old icons still show.Browsers cache fonts. Increase the version number in wp_register_style() (for example 1.0.1).

Summary #

  • Put your icon font and CSS in your own small plugin.
  • Add your classes with the rtcl_get_icon_class_list filter.
  • Load your CSS on the Form Builder screen, the admin listing screens and the front end.
  • Pick your icon in the Icon Library, insert it, and save the form.
What are your Feelings

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Still stuck? How can we help?

How can we help?

Updated on October 13, 2026
Image Crop FeatureMulti-Category Selection
Table of Contents
  • How it works
  • What you need
  • Step 1: Create a small plugin for your icons
  • Step 2: Check the icon CSS
  • Step 3: Write the plugin file
  • Step 4: Activate and test
  • Optional: show only your own icons
  • Optional: icons that need two classes
  • Troubleshooting
  • Summary
Copyright© 2026 RadiusDocs by RadiusTheme