alleyinteractive/wp-block-converter
Convert HTML into Gutenberg Blocks with PHP
v1.8.2
483K downloads/mo
#4518 most downloaded on Packagist
alleyinteractive/wp-block-converter
What this package is like to depend on
Last release 8 months ago
12 Dec 2025
Release timing varies
gaps range from 2 weeks to 10 months
Nearly every release is documented
notes for 15 of 15 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
15 releases · first in 2022
4 releases in the last 12 months
see the full history below
Release timeline
15 releases · Dec 2022 to Dec 2025
2023
2024
2025
2026
Releases
latest 15-
v1.8.212 Dec 2025Release notes
Open source →Changed
- Drop the CLI command added in 1.8.0. It is causing downstream issues that need to be resolved before it can be re-added.
Release notes
Open source →Changed
- Drop the CLI command added in 1.8.0. It is causing downstream issues that need to be resolved before it can be re-added.
-
v1.8.112 Dec 2025Release notes
Open source →Fixed
- Fix issue with CLI command not being registered in some environments.
Release notes
Open source →Fixed
- Fix issue with CLI command not being registered in some environments.
-
v1.8.010 Dec 2025Release notes
Open source →Added
- Added CLI command to convert posts to blocks.
Fixed
- Fix issue with double spaces being removed when converting.
- Fix issue with
pretags not being converted correctly.
Release notes
Open source →Added
- Added CLI command to convert posts to blocks.
Fixed
- Fix issue with double spaces being removed when converting.
- Fix issue with
pretags not being converted correctly.
-
v1.7.009 Dec 2025Release notes
Open source →- Fix issue where parent images were being sideloaded when
sideload_imageswas set to false. - Fix issue with importing Microsoft Word documents.
Release notes
Open source →Fixed
- Fix issue where parent images were being sideloaded when
sideload_imageswas set to false. - Fix issue with importing Microsoft Word documents.
- Fix issue where parent images were being sideloaded when
-
v1.6.021 Apr 2025Release notes
Open source →Added
- Added
wp_block_converter_pre_sideload_imagehook to allow select images to be disabled when sideloading.
Changed
- Sideloading of images is now opt-in. You can enable it by setting the
sideload_imagesoption totruewhen creating the converter instance.
Release notes
Open source →Added
- Added
wp_block_converter_pre_sideload_imagehook to allow select images to be disabled when sideloading.
Changed
- Sideloading of images is now opt-in. You can enable it by setting the
sideload_imagesoption totruewhen creating the converter instance.
- Added
-
v1.5.218 Feb 2025 -
v1.5.116 Dec 2024 -
v1.5.012 Aug 2024Release notes
Open source →Added
- Add collection of attachments that are created during the conversion process.
Two methods now exist on the converter to help:get_created_attachment_ids()- Returns the attachment IDs that were created.assign_parent_to_attachments()- Assigns a parent post to all attachments.
Changed
- Nested images are now properly sideloaded and converted to image blocks where
appropriate. For example, an image inside a figure tag will now be converted
to an image block. An image within a paragraph tag will be sideloaded but
won't be converted to an image block.
Full Changelog: v1.4.0...v1.5.0
Release notes
Open source →Added
- Add collection of attachments that are created during the conversion process.
Two methods now exist on the converter to help:
get_created_attachment_ids()- Returns the attachment IDs that were created.assign_parent_to_attachments()- Assigns a parent post to all attachments.
Changed
- Nested images are now properly sideloaded and converted to image blocks where appropriate. For example, an image inside a figure tag will now be converted to an image block. An image within a paragraph tag will be sideloaded but won't be converted to an image block.
- Add collection of attachments that are created during the conversion process.
-
v1.4.025 Jul 2024Release notes
Open source →- Drops support for PHP 8.0.
- Fixes issue with
<embed>elements.
Full Changelog: v1.3.2...v1.4.0
-
v1.3.228 Mar 2024Release notes
Open source →- Preserve new lines in embed blocks. They are required for proper front end rendering.
- Fix aspect ratio calculation when height and width are percentages - which fixes TikTok embeds.
-
v1.3.127 Mar 2024 -
v1.3.028 Feb 2024Release notes
Open source →- Adds macro support to the converter, allowing for custom tags to be added to the converter.
- Adds support for
hrtags. - Adds support for embeds.
-
v1.2.007 Nov 2023Release notes
Open source →- Enhancement: Adds support for non-standard ports in sanitized URLs (e.g., 8080).
- Enhancement: Added new filter called
wp_block_converter_sanitized_image_urlwhich allows the image URL for converted images to be filtered before being applied. - Bugfix: Changed the behavior of the
create_or_get_attachmentfunction to throw an exception instead of returning aWP_Error, which wasn't being handled previously and would result in a crash if a non-string value was returned byupload_image. - Bugfix: Ensure
upload_imagereturns the image URL.
-
v1.1.018 Oct 2023 -
v1.0.020 Dec 2022