Mudrava Icon Field for ACF with Lucide

Mudrava Icon Field for ACF with Lucide adds a new field type to Advanced Custom Fields (ACF) that allows users to select icons from the Lucide icon library through an intuitive visual picker. The selected icon name is stored in the database, making it lightweight and flexible for frontend rendering.

Requirements: This plugin requires Advanced Custom Fields (ACF) Pro version 6.0 or higher to function.

Features

• Visual Icon Picker – Browse and select from 1,500+ Lucide icons
• Smart Search – Filter icons by name or tags instantly
• Performant – Local sprite file, paginated grid (100 icons per page)
• Native ACF Look – Seamlessly integrates with ACF’s design language
• Responsive – Works on all screen sizes
• Accessible – Keyboard navigation support
• Flexible Output – Return icon name or full SVG markup
• No External Requests – All icon data is stored locally

Usage

After installing both ACF Pro and this plugin:

1. Go to Custom Fields > Add New
2. Add a new field and select Lucide Icon as the field type
3. Configure the field settings (default value, return format, etc.)
4. Save your field group

Template Examples

Get Icon Name:

<?php
$icon_name = get_field('your_field_name');
echo esc_html($icon_name); // Returns: 'rocket'
?>

Get SVG Markup (with return_format = ‘svg’):

<?php
$icon_svg = get_field('your_field_name');
echo $icon_svg; // Returns: <svg>...</svg>
?>

Using the Helper Function:

<?php
// Basic usage
echo mudrava_get_lucide_icon('rocket');

// With custom attributes
echo mudrava_get_lucide_icon('rocket', [
    'class'  => 'my-custom-class',
    'width'  => 32,
    'height' => 32,
    'stroke' => '#ff0000',
]);
?>

About Lucide Icons

Lucide is a modern, open-source icon library with 1,500+ carefully crafted icons. All icons are licensed under ISC, making them free to use in commercial and personal projects.

Privacy

Data Collection:

This plugin does not collect, store, or transmit any user data or personal information.

External Requests:

This plugin does not make any external HTTP requests. All icon data is stored locally and served from your WordPress installation.

Cookies:

This plugin does not use cookies.

Third-Party Services:

This plugin does not integrate with or send data to any third-party services.