Title: Subtle Icons &#8211; SVG Icon Block Suite, Icon Picker &amp; ACF Field
Author: Evan Buckiewicz
Published: <strong>2026년 5월 29일</strong>
Last modified: 2026년 6월 10일

---

플러그인 검색

![](https://ps.w.org/subtle-icons/assets/banner-772x250.png?rev=3554181)

![](https://ps.w.org/subtle-icons/assets/icon.svg?rev=3552964)

# Subtle Icons – SVG Icon Block Suite, Icon Picker & ACF Field

 작성자: [Evan Buckiewicz](https://profiles.wordpress.org/evanworks/)

[다운로드](https://downloads.wordpress.org/plugin/subtle-icons.1.1.1.zip)

 * [세부사항](https://ko.wordpress.org/plugins/subtle-icons/#description)
 * [평가](https://ko.wordpress.org/plugins/subtle-icons/#reviews)
 *  [설치](https://ko.wordpress.org/plugins/subtle-icons/#installation)
 * [개발](https://ko.wordpress.org/plugins/subtle-icons/#developers)

 [지원](https://wordpress.org/support/plugin/subtle-icons/)

## 설명

[Subtle Icons](https://subtleblocks.com/icons) is a lightweight plugin that brings
thousands of icons directly into the WordPress block editor and Advanced Custom 
Fields (ACF).

Stop enqueuing heavy FontAwesome stylesheets. Subtle Icons generates clean, inline
SVG code natively in the editor, keeping your frontend free of external scripts 
and font files.

### The Ultimate WordPress Icon Picker

Powered by the massive [Iconify](https://icon-sets.iconify.design/) ecosystem, easily
search and insert icons from dozens of popular open-source libraries without leaving
the WordPress editor. Supported libraries include:

 * Lucide Icons
 * Material Design Icons
 * Heroicons
 * FontAwesome
 * Bootstrap Icons
 * Phosphor Icons
 * …and dozens more, or upload your own custom SVGs!

### Four Native Gutenberg Icon Blocks

 * **Icon Button Block:** Prompt visitors to take action with a native-feeling button
   block supporting leading and trailing icons.
 * **Icon + Text Block:** Pair an icon with text for notices, callouts, and feature
   highlights.
 * **Icon Block:** A standalone SVG icon block with sizing, thickness, and color
   controls.
 * **Icon List Block:** Build beautiful, responsive lists with custom leading icons.

### Advanced Custom Fields (ACF) Integration

Bring icons to your structured content. Subtle Icons adds a fully integrated Icon
Picker field to ACF. Add icons to taxonomies, repeaters, options pages, and custom
blocks seamlessly.

### Built for Developers & Custom Integrations

Take full control of the icon workflow. Use our lightweight filters and actions 
to tailor the experience for your clients and custom builds.

 * Filter or restrict available icon collections
 * Configure default block icons globally
 * Robust developer documentation and more extensibility coming soon!

### Development

The complete source code for this plugin, including all uncompiled JavaScript and
CSS, is available at this [public GitHub repo](https://github.com/skysarwer/subtle-icons).

Build requirements: Node.js and npm.

To build from source:

 1. Clone the repository: `git clone https://github.com/skysarwer/subtle-icons`
 2. Install dependencies: `npm install`
 3. Compile assets for production: `npm run build`
 4. Or start a development watcher: `npm start`

### External Services

This plugin uses the [Iconify](https://iconify.design/) API to power the Icon Picker.
The API is never called on the public frontend; it only runs in the WordPress admin
when actively used by a logged-in user with post-editing capabilities. No personally
identifiable information (PII) is transmitted.

#### How Data is Sent

 * **Server-to-Server (Proxy):** Search queries (keywords) and icon retrievals (
   set prefix and icon name) are routed through a REST endpoint on your WordPress
   server. Iconify only sees your server’s IP address for these requests.
 * **Direct from Browser:** Icon preview thumbnails in the search grid are loaded
   directly from the editor’s browser (via the @iconify/react library). The editor’s
   IP address and standard browser headers are visible to Iconify for these image
   requests.

#### API Endpoints (all operated by the Iconify project):

 * **Primary:** [api.iconify.design](https://api.iconify.design)
 * **Fallbacks:** [api.simplesvg.com](https://api.simplesvg.com), [api.unisvg.com](https://api.unisvg.com)

#### Iconify Policies & Links:

 * [API documentation](https://iconify.design/docs/api/)
 * [Privacy policy](https://iconify.design/privacy/)

## 스크린샷

[⌊The Icon Picker interface natively integrated into the Icon Button block.⌉⌊The
Icon Picker interface natively integrated into the Icon Button block.⌉[

The Icon Picker interface natively integrated into the Icon Button block.

[⌊The ACF Icon Picker being used for a custom Subjects taxonomy.⌉⌊The ACF Icon Picker
being used for a custom Subjects taxonomy.⌉[

The ACF Icon Picker being used for a custom Subjects taxonomy.

## 블록

이 플러그인은 5개의 블록을 제공합니다.

 *   Icon Button Prompt visitors to take action with a button-style link that can
   include an SVG icon.
 *   Icon + Text Pair an icon with a text label. Useful for notices, callouts and
   rich headings.
 *   Icon Choose and display an icon.
 *   Icon List An organized collection of items displayed in a specific order.
 *   Icon List Item An individual item within a list.

## 설치

 1. Upload the plugin files to the `/wp-content/plugins/subtle-icons` directory, or
    install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress.
 3. Open the Block Editor and search for “Icon” to start using the blocks.

## FAQ

### Does this require Advanced Custom Fields?

No! The custom blocks work perfectly out of the box. The ACF field is just a bonus
for developers who want to integrate icons into custom meta boxes.

### Are the icons loaded locally or remotely?

The Icon Picker connects to Iconify via a proxy API to search icons, but the SVG
code is embedded directly into your content. No third-party frontend assets are 
loaded on your live site.

### How are the SVGs sanitized against malicious code?

Every icon is cleaned up twice before it ever touches your database — once in the
browser the moment an icon is chosen, and again on the server when the post is saved.
Both passes use strict allowlists that permit only the elements a real icon needs.
Anything that could execute code or load an external resource is removed automatically,
regardless of where the SVG came from.

The icon search itself only works for logged-in users who can already edit posts,
so the feature is not exposed to the public.

## 후기

![](https://secure.gravatar.com/avatar/8467bf8cef1ff149314cd2fb92a25b9338717d70fa3da4662ea5b4b0dde3559c?
s=60&d=retro&r=g)

### 󠀁[Fresh upgrade to all my lists + buttons](https://wordpress.org/support/topic/fresh-upgrade-to-all-my-lists-buttons/)󠁿

 [genesistutoring](https://profiles.wordpress.org/genesistutoring/) 2026년 6월 9
일 답글 1개

As a tutoring centre, we have a lot of lists that look repetitive, as well as a 
lot of call to action buttons that we need to stand out. This plugin has been perfect
for helping users space out complex lists of offerings, and using size / placement
to clearly see calls to action. We use this plugin all over our site.

 [ 모든 1 평가 읽기 ](https://wordpress.org/support/plugin/subtle-icons/reviews/)

## 기여자 & 개발자

“Subtle Icons – SVG Icon Block Suite, Icon Picker & ACF Field”(은)는 오픈 소스 소프트웨어입니다.
다음의 사람들이 이 플러그인에 기여하였습니다.

기여자

 *   [ Evan Buckiewicz ](https://profiles.wordpress.org/evanworks/)

[자국어로 “Subtle Icons – SVG Icon Block Suite, Icon Picker & ACF Field”(을)를 번역하세요.](https://translate.wordpress.org/projects/wp-plugins/subtle-icons)

### 개발에 관심이 있으십니까?

[코드 탐색하기](https://plugins.trac.wordpress.org/browser/subtle-icons/)는, [SVN 저장소](https://plugins.svn.wordpress.org/subtle-icons/)
를 확인하시거나, [개발 기록](https://plugins.trac.wordpress.org/log/subtle-icons/)
을 [RSS](https://plugins.trac.wordpress.org/log/subtle-icons/?limit=100&mode=stop_on_copy&format=rss)
로 구독하세요.

## 변경이력

#### 1.1.1

 * Fix Icon + Text alignment bug

#### 1.1.0

 * Improve Icon List `enter` key UX and other minor editor improvements
 * Support for wrapping `<span>` tags on icons

#### 1.0.7

 * Test up to WP 7.0, update readme and plugin assets

#### 1.0.2

 * Initial release of Subtle Icons.

## 기초

 *  버전 **1.1.1**
 *  최근 업데이트: **18시간 전**
 *  활성화된 설치 **90+**
 *  워드프레스 버전 ** 6.5 또는 그 이상 **
 *  다음까지 시험됨: **7.0**
 *  PHP 버전 ** 7.4 또는 그 이상 **
 *  언어
 * [English (US)](https://wordpress.org/plugins/subtle-icons/)
 * 태그:
 * [acf](https://ko.wordpress.org/plugins/tags/acf/)[gutenberg](https://ko.wordpress.org/plugins/tags/gutenberg/)
   [icon](https://ko.wordpress.org/plugins/tags/icon/)[icon picker](https://ko.wordpress.org/plugins/tags/icon-picker/)
   [icon-block](https://ko.wordpress.org/plugins/tags/icon-block/)
 *  [고급 보기](https://ko.wordpress.org/plugins/subtle-icons/advanced/)

## 평점

 별 5점 만점에 5점.

 *  [  1/5-별점 후기     ](https://wordpress.org/support/plugin/subtle-icons/reviews/?filter=5)
 *  [  0/4-별점 후기     ](https://wordpress.org/support/plugin/subtle-icons/reviews/?filter=4)
 *  [  0/3-별점 후기     ](https://wordpress.org/support/plugin/subtle-icons/reviews/?filter=3)
 *  [  0/2-별점 후기     ](https://wordpress.org/support/plugin/subtle-icons/reviews/?filter=2)
 *  [  0/1-별점 후기     ](https://wordpress.org/support/plugin/subtle-icons/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/subtle-icons/reviews/#new-post)

[모든  리뷰 보기](https://wordpress.org/support/plugin/subtle-icons/reviews/)

## 기여자

 *   [ Evan Buckiewicz ](https://profiles.wordpress.org/evanworks/)

## 지원

지난 2개월 동안 해결된 문제:

     1 중 0

 [지원 포럼 보기](https://wordpress.org/support/plugin/subtle-icons/)