The Icon display format renders field values as icons inside the editor and on the frontend. The plugin resolves whichever icon source the value points at — a Dashicon, a Media Library attachment, a direct image URL, or a custom registered icon set — and outputs the appropriate markup automatically.

Because the underlying value carries its own type information, a single Icon block can render any source the ACF Icon Picker field supports without further configuration.

Supported Field Types

The Icon display format supports the following field types:

• Icon Picker

Customization

The Icon display format includes a small set of customization options focused on sizing and fallbacks.

Customization	Description	Note
Default Icon	Sets a fallback icon rendered when the bound field has no value. Picked from the Media Library via the standard MediaReplaceFlow; can be removed with “Remove Icon”.	Lives in the Output Settings panel.
Icon Size	Sets the rendered icon’s width and height in pixels. Range: 12–200, step 1. Default: 24.	Lives in the Dimensions panel. Applied to all icon types — Dashicons (font-size), Media Library / URL / custom icons (width and height on the <img>).
Duotone Filter	Applies a WordPress duotone filter (two-color recolor) to the icon.	Standard WordPress block support (Filter → Duotone). Useful for tinting Media Library or URL icons without re-uploading.
Block Alignment	Block-level placement. Options: left, center, right.	Standard WordPress block support, exposed via the block toolbar.