SVG Block


This SVG block allows you to display SVG images as inline HTML markup. You can either choose an icon from the icon library with more than 3000 icons or you can upload or input your custom SVG images directly in the block’s setting.
It also allows you to upload SVG images to the WordPress media library, and load them into the icon library. Only SVG files that have XML declaration at the top like <?xml version="1.0" encoding="utf-8"?> can be uploaded to the WordPress media library.

Key Features

  • Accessibility ready with ‘img’ role, automatically generates title and description from settings.
  • Automatically sanitize SVG markup to make it safe and lightweight.
  • Include almost all settings to customize the SVG image.
  • Include a collection of common non-rectangular dividers.
  • An icon library included icons from „Bootstrap Icons“, „Ionicons“, „Dashicons“ and new „WordPress Icons“.
  • Allow uploading SVG images to the WordPress media library
  • Automatically load SVG images from the media library into the icon library

Video tutorials

How to create an icon with custom styles using the icon library:

How to create a non-rectangular background section:

How to create icon buttons:

Please take a look at these custom block patterns that use this block to see how it can be applied to real-world sites.

If this plugin is useful for you, please do a quick review and rate it on to help us spread the word. I would very much appreciate it.

Please check out my other plugins if you’re interested:

  • Content Blocks Builder – A tool to create blocks, patterns or variations easily for your site directly on the Block Editor.
  • Meta Field Block – A block to display a meta field or an ACF field as a block. It can also be used in the Query Loop block.
  • Block Enhancements – A plugin to add more useful features to blocks like icons, box-shadow, transform, hover style, etc.
  • Icon separator – A tiny block just like the core/separator block but with the ability to add an icon to it.
  • Counting Number Block – A block to display a number that has the number-counting effect.
  • Breadcrumb Block – A simple breadcrumb trail block that supports JSON-LD structured data.
  • Better YouTube Embed Block – Embed YouTube videos without slowing down your site.

The plugin is developed using @wordpress/create-block.


  • Create an arrow background section

  • Add an icon and add styling to it

  • Create a curved background section

  • Use the responsive height feature

  • Use the SVG block as the image block

  • Block’s settings

  • Block’s placeholder


This plugin provides 1 block.

  • SVG Block Display an SVG image as a block, which can be used for displaying images, icons, dividers, buttons


  1. Upload the plugin files to the /wp-content/plugins/svg-block directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress


What problem does this plugin solve?

It helps to input inline SVG images as blocks easily and safely. You can use SVGs from the icon library or upload your own. It also supports uploading SVG images to the media library and displaying them with this block.

When should we use this plugin?

  • When you need to quickly input some icons. It bundles with more than 3000 icons from some popular icons library such as „WordPress“, „Dashicons“, „Ionicons“, and „Bootstrap icons“.
  • Or you need to use an SVG image as a divider, or separator. It also bundles with some common non-rectangular dividers like tilts, curves, triangles…
  • You can also use it as an image block but for SVG format only like images from
  • You can also use it as a button with an icon, and it can be nested inside the Query Loop with the ‘Link to post’ enabled.

Why needs this plugin?

It’s super easy to use. It’s accessibility-ready. It comes with lots of additional features like responsive width and height, responsive spacing (padding and margin), responsive justify alignment, flip, revert, responsive border, border-radius, box-shadow builder…

Who needs this plugin?

Anyone can use this plugin.


21. Juni 2024. 2 replies
Excellent plugin, but you did miss aria label for links. This impact Accessibility scores at lighthouse test.Could you please add the possibility to set up that label in the block setting please?Thanks!
19. Juni 2024. 1 reply
This plugin adds some missing functionality that Gutenberg should have by default. It’s great. The developer is also very receptive and quick in adding features.
15. Juni 2024. 1 reply
Hello, This extension is really very complete.I’ve posted the full French translation on Give me feedback if you wish.
16. Maj 2024. 1 reply
I was looking for a plugin that made it easier to embed SVG files directly, rather than linking them as an image. This plugin works great. The SVG browser has a bunch of pre-loaded icons, and automatically imports any SVG files you upload as well. The separator shape blocks are a nice touch I didn’t even think of. I’m definitely going to keep using this plugin on other sites. Highly recommended. Thank you for the great plugin!
22. Januar 2024. 3 replies
This is very handy. Would love an option disabling everything except the use of custom SVG from the media library.
Read all 11 reviews

Contributors & Developers

“SVG Block” is open source software. The following people have contributed to this plugin.


“SVG Block” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “SVG Block” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



Release Date – 03 July 2024

  • Improved – Refactor code to make the placeholder look good when installing the block from the inserter
  • Improved – Adjust vertical spacing style for some inspector controls
  • Added – Support clientNavigation interactivity


Release Date – 30 May 2024

  • Updated – Update the unique ID for the SVG on the server
  • Refactor – Vertical spacing
  • Improved – Adjust the styling for the replacement SVG dropdown in the contentOnly mode


Release Date – 22 May 2024

  • Improved – The SVG URL input UI component
  • Updated – Put the shadow panel inside the Border panel
  • Improved – Allow inputting alpha value for colors
  • Fixed – Fix some small styling issues


Release Date – 28 April 2024

  • Improved – Uploading SVGs: sanitize and allow only the administrator can upload SVG


Release Date – 19 April 2024

  • Added – Allow inputting SVG data, URL, button text on the content only locking
  • Updated – Refactor code


Release Date – 01 April 2024

  • Added – Allow the ability to exclude the icon library from the icon popup
  • Updated – Update SDK
  • Updated – Icon Library


Release Date – 31 October 2023

  • Added – Allow uploading SVG images to the WordPress media library and load those images into its icon library
  • Updated – Update icons from the latest version of third-party providers
  • Updated – Update SDK


Release Date – 22 September 2023

  • Added – New setting named linkToPost. The block now can be used in a Query Loop and acts like a link/button with an icon that links to the post
  • Updated – Update ‘Requires at least’ to 6.3 for the new HTML API, and new default size controls
  • Fixed – Change border from BorderBoxControl to BorderControl


Release Date – 08 September 2023

  • FIX – Generate empty variables for margin


Release Date – 03 September 2023

  • DEV – Use the default control for border, spacing settings
  • DEV – Disable toggle off for width, icon width, gap between icon and text


Release Date – 09 August 2023

  • DEV – Update new style for the icon library popup in WP 6.3
  • DEV – Refactor code


Release Date – 28 June 2023

  • DEV – Use ToolsPanel for inspector controls
  • DEV – Improve performance


Release Date – 11 March 2023

  • DEV – Update icon library
  • DEV – Add more clear help texts for the title and the description
  • DEV – Refactor for WP 6.2


Release Date – 09 February 2023

  • DEV – Add better support for the ‘Use as button’ feature


Release Date – 03 February 2023

  • DEV – Add SVGO GUI tool to the help text
  • DEV – Update SDK


Release Date – 27 October 2022

  • DEV – Allow clear color for the ColorGradientControl


Release Date – 04 October 2022

  • FIX – placeholder’s style is not loading in the site editor


Release Date – 03 October 2022

  • FIX – Focus on the search box on the first load


Release Date – 29 September 2022

  • REFACTOR – Redesign the placeholder for the block
  • DEV – Add divider icons to the icon library
  • REFACTOR – Using a data store for the icon library
  • FIX – Remove empty style variables and add deprecated for them


Release Date – 18 September 2022

  • FIX – Compatibility issue with the Gutenberg plugin
  • DEV – Refactor for localization


Release Date – 31 August 2022

  • DEV – Add stack context


Release Date – 30 August 2022

  • DEV – Change the default value for box-shadow
  • FIX – Reset icon lists by clicking on the reset search button


Release Date – 27 July 2022

  • FIX – The block makes the page in ‘dirty’ state


Release Date – 26 July 2022

  • DEV – Allow the ability to turn the block into a button with text & icon
  • DEV – Add ‘auto’ value to the options of width and height
  • DEV – Double click on the icon on the modal to insert the icon


Release Date – 01 July 2022

  • DEV – Add box-sizing as border-box by default


Release Date – 30 Jun 2022

  • FIX – Convert inline style to style object


Release Date – 19 Jun 2022

  • DEV – Update SDK
  • DEV – Refactor icon library modal
  • DEV – Allow uploading SVG files


Release Date – 12 May 2022

  • REFACTOR Update sdk


Release Date – 30 April 2022

  • FIX – Missing color slug


Release Date – 30 April 2022

  • DEV – Upgrade color format


Release Date – 28 April 2022

  • DEV – Add title to block registration in JS


Release Date – 21 April 2022

  • DEV – Optimize code for performance


Release Date – 19 April 2022

  • REFACTOR – Move the PanelColorGradientSettings out of PanelBody


Release Date – 15 April 2022

  • DEV – Icon library modal: focus the search box on open, press enter to insert icon


Release Date – 12 April 2022

  • FIX – Remove old cached icons due to storage limitation issue.


Release Date – 10 April 2022

  • DEV – Update icons pack


Release Date – 07 April 2022

  • FIX – Fix typo issue


Release Date – 05 April 2022