Icons make pages easier to scan. A small check mark beside each feature, a phone icon next to your number, or a row of social icons in the footer all help visitors find what they need faster. The catch is choosing the right format: blurry PNGs and heavy icon fonts can undo the benefit. This guide to SVG icons in Gutenberg shows a lighter way.
You’ll learn why SVG is the best format for icons, how to add, size and color them with the free SVG Icon Block plugin, and how to keep icons accessible and safe. Everything happens inside the block editor, no code required.
Why Use SVG Icons?
SVG (Scalable Vector Graphics) describes shapes with code instead of pixels. That gives icons a few big advantages:
- Crisp at any size. An SVG looks sharp on a phone, a 4K monitor and everything between.
- Small files. Simple icons are often just a few lines of markup.
- Easy to color. You can change fill and stroke colors without editing an image file, including on hover.
- No icon font. Inline SVG icons don't require loading a whole font file to show a handful of symbols.
PNG icons get blurry when scaled and need separate files for each color. Icon fonts typically load the whole set even if you only use three icons. Inline SVG avoids both problems.
Meet SVG Icon Block
SVG Icon Block is a free plugin that adds an icon block to WordPress. It renders icons as SVG code and has no third-party dependencies.
Key features:
- Font Awesome icons as SVG: browse solid, regular and brand icons, output as direct SVG rather than a font library.
- SVG upload: upload your own SVG file.
- Custom SVG code: paste SVG markup directly.
- My Icons library: save your own SVG once and reuse it in any post or page. The library is shared with everyone on the site who can edit posts.
- Transform options: rotate the icon and flip it horizontally or vertically.
- Styling controls: size, fill, stroke and path colors, background, border, border radius and padding, with separate normal and hover states.
- Link and label options: link the icon, and show a text label next to it.

How to Add SVG Icons in Gutenberg, Step by Step
Step 1: Install the plugin
- In your dashboard, go to Plugins → Add New.
- Search for "SVG Icon Block".
- Click Install Now, then Activate.
Step 2: Insert the SVG Icon block
- Open a page or post and click the + block inserter.
- Search for "SVG Icon" and insert the block.
- The block placeholder gives you ways to add an icon.
Step 3: Choose your icon source
Pick the option that fits your icon:
- Icon library: browse or search the Font Awesome solid, regular and brand sets and click an icon to insert it.
- Upload SVG: upload an SVG file, for example a custom icon from your designer.
- Custom SVG: paste SVG code. Turn on Add to My Icons and give it a label if you want to reuse it later.
- My Icons: once you've saved icons, pick them from your library without pasting the code again.
Step 4: Set size, color and alignment
- With the block selected, open the block settings sidebar.
- Set the icon size with the size slider or number field.
- Choose a fill color. If your icon is line-based, set the stroke or path color instead.
- Switch to the hover state to choose a different color when visitors point at the icon.
- Set the alignment so the icon sits left, center or right.
Step 5: Add a background, border or link (optional)
- Add a background color, border and border radius to place the icon inside a badge or circle.
- Use padding to give the icon breathing room inside its badge.
- Rotate or flip the icon if you need it to point a different way.
- Turn on the link option to make the icon clickable, and decide whether it opens in a new tab.
Practical Ways to Use Icons
Feature lists
Put a Columns block on the page and add an SVG icon, a heading and a short paragraph in each column. Use the same icon size and color in every column so the row looks consistent. This works especially well on service pages and in pricing tables in Gutenberg.
Contact details
Use a phone, envelope and map pin icon next to your contact information. Turn on the label option to show the text right beside the icon.
Social links
The brand icon set includes common social logos. Use the link option to point each icon to your profile and set a hover color that matches your brand.
Icons with buttons
Place an icon next to a button inside a Row block, for example an arrow or a download symbol. Keep the icon the same color as the button text for a clean look.
Tabs and timelines
Icons also help in tabbed content and timelines, where a small symbol makes each section easier to recognize at a glance.
Accessibility: Decorative vs Meaningful Icons
Not every icon needs to be “read” by a screen reader. The question is whether the icon carries information on its own.
- Decorative icons sit next to text that already says the same thing, like a check mark beside "Free shipping." The text does the work, so the icon is just visual support.
- Meaningful icons stand alone, like a linked Instagram logo with no text. Here, people using screen readers need a text alternative to know where the link goes.
The simplest fix is to make sure important icons always have visible text nearby, for example by turning on the block’s label option. For standalone linked icons, test them with a screen reader to confirm they make sense. Google’s guide to accessible images explains decorative and informative images in more detail.
Also check color contrast. A pale gray icon on a white background may look elegant, but many visitors won’t see it.
A Quick Note on SVG Security
SVG files are code, which means they can contain scripts. That’s why WordPress doesn’t allow SVG uploads by default.
SVG Icon Block sanitizes icons before storing them. According to the plugin, saved icons go through the same security checks as uploaded SVG files, which strip out scripts, event handlers and unsafe links. Even so, only use SVG files from sources you trust, such as your designer or a reputable icon set. For broader site hardening tips, see the WordPress hardening guide.
Best Practices for Icons in WordPress
- Pick one icon style. Don't mix solid and outline icons in the same section.
- Keep sizes consistent. Use the same size for icons that sit side by side.
- Use brand colors sparingly. One accent color for icons is usually enough.
- Save brand icons to My Icons. Your logo mark or custom icons stay consistent across the team.
- Optimize custom SVGs. Exported SVGs often include editor metadata. Clean them up before pasting.
- Don’t replace words with icons. Icons support text. They rarely replace it well.
Frequently Asked Questions
Does SVG Icon Block load Font Awesome as a font?
No. The Font Awesome icons are rendered as direct SVG code, not as an icon font library, so only the icons you use end up on the page.
Can I use my own SVG icons?
Yes. You can upload an SVG file or paste SVG code. Turn on Add to My Icons to save it to a shared library and reuse it in any post or page.
Can I change an icon’s color on hover?
Yes. The block has separate normal and hover settings, so you can set different colors for when a visitor points at the icon.
Is it safe to paste SVG code?
The plugin sanitizes saved icons and strips scripts, event handlers and unsafe links. You should still only use SVG code from sources you trust.
Conclusion: Start Using SVG Icons in Gutenberg
Adding SVG icons in Gutenberg is one of the easiest ways to make pages clearer and more polished. SVGs stay sharp at any size, are easy to recolor, and avoid the weight of an icon font. With SVG Icon Block, you can pick from Font Awesome, upload your own, or reuse saved icons in a couple of clicks. It’s a workflow for SVG icons in Gutenberg that stays inside the editor you already use.
Get SVG Icon Block for free on WordPress.org, and check out our other Gutenberg plugins for more lightweight blocks.




Leave a Reply
You must be logged in to post a comment.