{"id":16367735,"date":"2026-05-20T12:00:00","date_gmt":"2026-05-20T12:00:00","guid":{"rendered":"https:\/\/wordpress.org\/documentation\/?post_type=helphub_article&#038;p=16367735"},"modified":"2026-05-20T16:08:13","modified_gmt":"2026-05-20T16:08:13","slug":"icon-block","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/icon-block\/","title":{"rendered":"Icon block"},"content":{"rendered":"\n<p class=\"has-text-align-right has-small-font-size wp-block-paragraph\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/blocks\/\">Go back to the list of Blocks<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Icon block lets you easily add icons to your pages, posts, templates, and template parts. Icons can be resized without losing quality and support custom colors for both the icon and its background.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"822\" style=\"aspect-ratio: 1486 \/ 822;\" width=\"1486\" controls poster=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-6.15.10-PM.png\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Kapture-2026-05-13-at-18.13.55.mp4\"><\/video><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Add an Icon block<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To add an Icon&nbsp;block, open the Block Inserter tool by clicking the Block Inserter + icon in the top toolbar. Look for the&nbsp;Icon&nbsp;block by using the search bar to find the right block to add. Then, click the icon to insert the&nbsp;Icon block into the editor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Alternatively, click the Block Inserter (+) icon in the editor, then choose the Icon block after searching for it in the pop-up window.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can also use a (\/) slash command by typing&nbsp;<code>\/icon<\/code>&nbsp;in the editor.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"538\" height=\"316\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-5.43.02-PM.png\" alt=\"Adding the icon block in editor with a slash icon command\" class=\"wp-image-16367748\" style=\"aspect-ratio:1.7025531155150866;width:248px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-5.43.02-PM.png 538w, https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-5.43.02-PM-300x176.png 300w\" sizes=\"auto, (max-width: 538px) 100vw, 538px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Block Toolbar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Each block has its own block-specific controls that allow you to manipulate the block right in the editor. If you hover over the buttons, tooltips will show what each button does.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Transform to <\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"650\" height=\"458\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-5.45.28-PM.png\" alt=\"Icon block transform options\" class=\"wp-image-16367749\" style=\"aspect-ratio:1.4193039223423565;width:329px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-5.45.28-PM.png 650w, https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-5.45.28-PM-300x211.png 300w\" sizes=\"auto, (max-width: 650px) 100vw, 650px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Click on the Transform button to convert the Icon block into a Columns, Details, or Group block.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Block moving tools<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"592\" height=\"118\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/icon-block-toolbar-move.png\" alt=\"Block moving tools on icon block toolbar\" class=\"wp-image-16367751\" style=\"width:300px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/icon-block-toolbar-move.png 592w, https:\/\/wordpress.org\/documentation\/files\/2026\/05\/icon-block-toolbar-move-300x60.png 300w\" sizes=\"auto, (max-width: 592px) 100vw, 592px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The block-moving tools allow you to move the block in the editor. Use the six dots icon to drag and drop the&nbsp;block and place it anywhere on the page. Alternatively, click on the up and down arrows to move the block up or down.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/moving-blocks\/\" target=\"_blank\" rel=\"noreferrer noopener\">Get more information about moving a block within the editor<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Align<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"592\" height=\"118\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/icon-block-toolbar-align.png\" alt=\"Block toolbar align button\" class=\"wp-image-16367752\" style=\"width:300px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/icon-block-toolbar-align.png 592w, https:\/\/wordpress.org\/documentation\/files\/2026\/05\/icon-block-toolbar-align-300x60.png 300w\" sizes=\"auto, (max-width: 592px) 100vw, 592px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Use the change alignment tool to align the Icon block. Choose one of the following options:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>None \u2013&nbsp;<\/strong>removes any alignment setting.<\/li>\n\n\n\n<li><strong>Align left \u2013&nbsp;<\/strong>aligns the block left.<\/li>\n\n\n\n<li><strong>Align center \u2013&nbsp;<\/strong>aligns the block to the center.<\/li>\n\n\n\n<li><strong>Align right \u2013&nbsp;<\/strong>aligns the block right.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Choose icon \/ Replace<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If you haven\u2019t selected an icon yet, click <strong>Choose icon<\/strong> to open the icon library and browse available options. If an icon is already selected, click <strong>Replace<\/strong> to choose a different one.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"822\" style=\"aspect-ratio: 1486 \/ 822;\" width=\"1486\" controls poster=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-5.52.04-PM.png\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Kapture-2026-05-13-at-17.51.39.mp4\"><\/video><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">More options <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The More options menu represented by three vertical dots on the far right of the toolbar gives you more features such as the ability to duplicate or remove the block.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\/\">Read about these and other settings<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Block Settings<\/h2>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"453\" height=\"104\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/block-settings-7-0-1.png\" alt=\"Block settings button\" class=\"wp-image-16367741\" style=\"width:279px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/block-settings-7-0-1.png 453w, https:\/\/wordpress.org\/documentation\/files\/2026\/05\/block-settings-7-0-1-300x69.png 300w\" sizes=\"auto, (max-width: 453px) 100vw, 453px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Every block has specific options in the editor sidebar in addition to the options found in the block toolbar.&nbsp;If you do not see the sidebar, click on the&nbsp;<strong>Settings button<\/strong>&nbsp;next to the Save\/Publish button.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Label<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"556\" height=\"732\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-6.01.51-PM.png\" alt=\"Icon settings showing label input box\" class=\"wp-image-16367757\" style=\"width:245px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-6.01.51-PM.png 556w, https:\/\/wordpress.org\/documentation\/files\/2026\/05\/Screenshot-2026-05-13-at-6.01.51-PM-228x300.png 228w\" sizes=\"auto, (max-width: 556px) 100vw, 556px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Add a label to briefly describe the icon to help screen reader users or leave blank for decorative icons.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Icon block provides the following Advanced settings options: HTML Anchor, Additional CSS Class(es), Additional CSS, and Styles.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/advanced-settings-overview\/\">Learn more about advanced settings<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Color <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Icon block provides Color settings options to change the text and background colors.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/colors-settings-overview\/\">See this guide for more information about changing colors<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dimensions <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Icon block provides dimension settings options to change padding and margin size.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/dimension-controls-overview\/\">Learn more about dimension controls<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Border<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Icon block provides border settings options to add border color, width, and radius.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/border-settings-overview\/\">Learn more about border settings<\/a><\/p>\n\n\n\n<div class=\"wp-block-group changelog has-background is-layout-flow wp-block-group-is-layout-flow\" style=\"background-color:#e0e0e0\">\n<h2 id=\"changelog\" class=\"wp-block-heading has-large-font-size\">Changelog <\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Created 2026-05-20<\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Go back to the list of Blocks The Icon block lets you easily add icons to your pages, posts, templates, and template parts. Icons can be resized without losing quality and support custom colors for both the icon and its background. Add an Icon block To add an Icon&nbsp;block, open the Block Inserter tool by [&hellip;]<\/p>\n","protected":false},"author":20811757,"featured_media":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false},"category":[80,84],"class_list":["post-16367735","helphub_article","type-helphub_article","status-publish","hentry","category-customization","category-media-blocks"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16367735","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles"}],"about":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/types\/helphub_article"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/users\/20811757"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=16367735"}],"version-history":[{"count":26,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16367735\/revisions"}],"predecessor-version":[{"id":16367980,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16367735\/revisions\/16367980"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16367735"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16367735"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}