SVG Flags – Country Flag Blocks and Galleries

SVG Flags of the world allows you to add high quality beautiful flags to your WordPress site in seconds. Display one or more flags at any scale without loss of quality and with a fixed aspect ratio so they always look great! Supported aspect ratios are 4:3 (default) and 1:1 (square). Create SVG flags visually in the block editor and preview them in real time. Choose from 271 current country, territory, regional, and organisation flags using a searchable selector, then control size, aspect ratio, captions, and layout without leaving the editor. The plugin includes three dynamic blocks:

• SVG Flag for a lightweight CSS-rendered flag.
• SVG Flag Image for an accessible image with country-name alternative text.
• SVG Flag Grid for responsive multi-country galleries with up to eight columns, adjustable spacing, captions, and square or 4:3 flags.

Shortcodes are available for classic-editor and template use. Add one flag with [svg-flag flag="gb"], an accessible image with [svg-flag-image flag="fr"], or a gallery with [svg-flag-grid flags="gb,us,ca,fr" columns="4" caption="true"]. Go further with SVG Flags Pro SVG Flags Pro adds linked flag cards, responsive linked grids, searchable and curated flag directories, flag headings, custom captions and tooltips, and deeper presentation controls. Reusable Pro flag collections let you maintain a named set of flags, labels, links, groups and ordering in one place. Use the Flag Collection block to display the same collection as a linked grid or searchable directory on multiple pages, or detach a local copy for a one-off layout. Build larger collections with CSV import and export. Preview and validate rows before saving, recover an earlier revision, or restore a collection from the bin. Collection blocks keep a plain linked-grid copy from the last page save so useful content remains when the collection or Pro is unavailable. Collection shortcodes require an active Pro licence. Explore SVG Flags Pro for the complete feature comparison and current pricing, or open the live demo to try the Free and Pro examples. We hope you find this plugin useful. If you have a moment please consider rating it to show your support. It's very much appreciated and helps spread the word. Also, why not take a look at our other plugins. We're continually developing great solutions for WordPress.

0.12.2, OCT 6, 2026

• Improved preservation of saved flag images when switching between Free and Pro plugin folders.
• Restored the logo and example images on the plugin admin pages.
• Kept WordPress and Freemius notices below the complete admin header.
• Added clearer Pro collection and CSV information, with direct product and live-demo links.
• Fixed early translation loading in the introductory pricing integration.

0.11.1, OCT 3, 2026

• Added favourite and recently used shortcuts to searchable flag pickers.
• Added direct move-up, move-down and removal controls to selected Flag Grid items.
• Expanded Home examples, documentation and release guidance for the current Free and Pro workflows.

0.10.0, SEP 1, 2026

• Added a unified admin Home with more one-click flag starter drafts and clearer guidance.
• Added persistent defaults for newly inserted Flag, Flag Image, and Flag Grid blocks.
• Added privacy-safe support diagnostics, improved keyboard and responsive admin behaviour, and accurate edition status after licence deactivation.
• Added direct routes to SVG Flags Pro and relevant WPGO companion plugins.

0.9.8, AUG 20, 2026

• Fix: Declared Block API v3 in every server-side block registration for the WordPress 7.1 iframed editor.

0.9.7, AUG 10, 2026

• Restored compatibility with current WordPress and PHP releases.
• Replaced the obsolete Node Sass build with a maintained Dart Sass and Webpack toolchain.
• Improved the editor country selector and fixed admin asset loading.
• Updated all blocks to Block API v3 and opted into current WordPress control sizing.
• Hardened flag, shortcode, and release configuration handling.
• Added a responsive multi-country Flag Grid block and shortcode.
• Added accessible image alternative text and lazy loading.
• Updated the Freemius SDK from 2.4.3 to 2.13.4.
• Updated the bundled flag library from flag-icon-css 3.4.5 to flag-icons 7.5.0, with 271 current flags and legacy CSS class compatibility.
• Replaced the legacy shared plugin framework with native SVG Flags admin and plugin services.

0.9.6, MAR 21, 2022

• Updated Freemius SDK to v2.4.3.

0.9.5, JAN 29, 2021

• Updated 3rd party libraries.
• Minor bug fixes and UI updates.

0.9.3, SEP 7, 2020

• New: Added a new [svg-flag-heading] shortcode.
• New: Added a block as an alternative to the [svg-flag-heading] shortcode.
• New: Added a block as an alternative to the [svg-flag-image] shortcode.
• Fixed: New features counter now working correctly.

0.9.2, SEP 7, 2020

• Patched bug in new features counter.

0.9.1, AUG 28, 2020

• Updated: Refactored code.

0.9.0, MAR 11, 2020

• New: Added new [svg-flag-image] shortcode.
• New: Attributes added to the [svg-flag] shortcode: size, size_unit.
• New: Attributes added to the [svg-flag] shortcode that were previously ONLY available in pro: caption, random, inline.
• New: Added new editor block which is a direct replacement to the [svg-flag] shortcode.
• Updated: Deployment script.

0.8, DEC 02, 2020

• Updated settings.

0.7, DEC 30, 2019

• Updated settings page.

0.6, DEC 24, 2019

• Maintenance release.

0.5, DEC 23, 2019

• Fixed 'square' shortcode attribute.
• Most of the code refactored.
• Compatible with WordPress 5.3.

0.4, MAY 21, 2019

• Minor bug fix.

0.3, MAY 21, 2019

• Added new [svg-flags] shortcode as a recent update to the Gutenberg block editor seems to strip out using the SVG flag HTML directly. Use the new shortcode to guarantee the flag will always display in the block editor and on the front end.

0.2, APRIL 26, 2019

• Flag SVG's updated to latest version (3.3).
• SVG flags now work in the WordPress (5.0+) block editor.

0.1, OCTOBER 25, 2017

• Initial plugin release!