Parsoid/Releases

This page shows the releases for Parsoid (GitHub - code repo / Packagist - releases listing). In addition to the stable releases listed here, unstable alpha versions of Parsoid are deployed weekly on the MediaWiki train; those can be found at Parsoid/Deployments.

Parsoid/PHP

Parsoid/PHP comes bundled with MediaWiki as a composer dependency.

0.21.0 (not yet released)

Parsoid 0.21 will come bundled with MediaWiki 1.44.

0.20.0 (released Oct 24, 2024)

Parsoid 0.20 will come bundled with MediaWiki 1.43.

0.19.1 (released Oct 24, 2024)

• phab:T372170: Preserve newlines in tpl arg names when not substituted

0.19.0 (released Apr 19, 2024)

Parsoid 0.19 was released with MediaWiki 1.42.

0.18.2 (released Mar 27, 2024)

• npm dependency updates

0.18.1 (released Dec 18, 2023)

• phab:T314099: Set default values explicitly in Wikimedia\Parsoid\Ext\Gallery\Opts

0.18.0 (released Nov 7, 2023)

Parsoid 0.18 was released with MediaWiki 1.41.

0.17.4 (released Mar 27, 2024)

• npm dependency updates

0.17.3 (released Jan 4, 2024

• phab:T237463, phab: T353644: Stop creating dynamic properties in SerializerState (php 8.2 compatibility)
• phab:T335847: Punt on trying to resolve subpages on "/"; no need to resolve subpages when resolving lonely fragments
• phab:T314099: Set default values explicitly in Wikimedia\Parsoid\Ext\Gallery\Opts

0.17.2 (released Nov 7, 2023)

• phab:T350594: Fix "DOMElement::setAttribute() expects parameter 2 to be string, null given" crasher

0.17.1 (released Oct 10, 2023)

• Dependency updates
  • Updated wikimedia/ip-utils to ^4.0.0 || ^5.0.0

0.17.0 (released Jun 9, 2023)

Parsoid 0.17 was released with MediaWiki 1.40.

0.16.4 (released Apr 6, 2024)

• phab:T361990 Add AllowDynamicProperties to Wikimedia\Parsoid\DOM\Document.

0.16.3 (released Feb 12, 2024)

• npm dpendency updates
• phab:T350594: Fix "DOMElement::setAttribute() expects parameter 2 to be string, null given"
• phab:T237463: Stop creating dynamic properties in SerializerState (php 8.2 compatibility)
• phab:T314099: Set default values explicitly in Wikimedia\Parsoid\Ext\Gallery\Opts

0.16.2 (released Oct 10, 2023)

• Dependency updates
  • Updated wikimedia/ip-utils to ^4.0.0 || ^5.0.0
  • Allow wikimedia/object-factory ^5.0.0
  • Update wikimedia/idle-dom to 1.0.0 (fixes PHP incompatibility on 32-bit systems)

0.16.1 (released Dec 1, 2022)

• Dependency updates
  • Updated qs to 6.11.0
  • phab:T307618: Removed wikimedia/dodo
• phab:T324902: Add body parameter for caching to DOM\Document
• PHP 8.2 compatibility
  • phab:T314099: Allow dynamic properties
  • Avoid self:: keyword

0.16.0 (released Oct 12, 2022)

Parsoid 0.16 was released with MediaWiki 1.39.

0.15.1 (released Sep 14, 2022)

• Dependency updates
  • Remove service-runner and a bunch of other dependencies
  • Note that this breaks Parsoid/JS, but it wasn't supported in 1.38 as it is. Parsoid/JS was EOL in 1.31
• Add type hints for php 8.1

0.15.0 (released June 2, 2022)

Parsoid 0.15 was released with MediaWiki 1.38.

0.14.2 (released Sep 14, 2022)

• Dependency updates
  • Remove service-runner and a bunch of other dependencies
  • Note that this breaks Parsoid/JS, but it wasn't supported in 1.37 as it is. Parsoid/JS was EOL in 1.31
• Add type hints for php 8.1

0.14.1 (released June 6, 2022)

• Dependency updates
• Don't try to deep clone DOM nodes, it throws an exception on PHP 8.1

0.14.0 (released Nov 16, 2021)

Parsoid 0.14 was released with MediaWiki 1.37.

0.13.0 (released Apr 21, 2021)

Parsoid 0.13 was released with MediaWiki 1.36.

0.12.3 (released Sep 14, 2022)

• Dependency updates
  • Remove service-runner and a bunch of other dependencies
  • Note that this breaks Parsoid/JS, but it wasn't supported in 1.35 as it is. Parsoid/JS was EOL in 1.31
• Add type hints for php 8.1
• Fix for bin/parse.php in --integrated mode

0.12.2 (released Apr 8, 2021)

Security release for the following:

• (T279451, CVE-2021-30458) SECURITY: Parsoid comment fostering allows for inserting mostly arbitrary <meta> tags.

Note

• Parsoid/PHP 0.12.2 comes bundled with MediaWiki 1.35.2

0.12.0 (released Sep 11, 2020)

Version 0.12.0 is the first stable release of Parsoid/PHP, released with MediaWiki 1.35 (a long-term support release). It was released as a library via composer as wikimedia/parsoid. On Debian this library is included with the mediawiki package and will not need to be separately packaged.

Notable changes:

• For the first time, VisualEditor and Parsoid work "out of the box" with zero manual configuration (just select 'Visual Editor' from the web installer), although in WMF production Parsoid is still run as a separate service behind RESTBase.

Parsoid/JS

Parsoid/JS was a debian package that needed to be installed separately. It is EOL as of September 2021.

The support for specific Node.js versions was dropped around the same time that the specific Node.js version reached its EOL.

0.11.1 (released Apr 8, 2021)

Security release for the following:

• (T279451, CVE-2021-30458) SECURITY: Parsoid comment fostering allows for inserting mostly arbitrary <meta> tags.

Notes

• This is a debian package for use by Parsoid/JS users.
• If you are having trouble getting 0.11.1 installed via apt-get, you can download the deb directly from https://releases.wikimedia.org/parsoid/.
• If you are on an older version of Parsoid/JS, check this commit to see how you could patch your repo.
• Parsoid/JS goes end-of-life when MediaWiki 1.31 LTS goes end-of-life and will not get any more security updates after that point.

0.11.0 (released Jan 14, 2020)

 This is the LAST release of the JS implementation of Parsoid, Parsoid/JS. Parsoid has been ported from JS to PHP and will be more closely integrated into MediaWiki and will not need its own debian package henceforth.

•  Updated bundled parsoid to git commit 5d37da17
•  See src/HISTORY.md for details of what changed in Parsoid. Notable changes:
  • Parsoid HTML version is now 2.1.0
  • Lots of code cleanup and code refactoring
  • Language converter move out to its own repo

This release is breaking (switching between visual and source editing) for versions of MediaWiki 1.31.x, possibly also 1.32.x and lower. If your are using one of these versions, do not upgrade Parsoid.

 Note: When using "apt" just issue apt-mark hold parsoid to prevent the upgrade of "parsoid". However, if you upgraded and broke your install, you can downgrade your Parsoid install by downloading an older deb package from https://releases.wikimedia.org/parsoid/

0.10.0 (released Dec 5, 2018)

• Updated bundled parsoid to git tag v0.10.0.
• See src/HISTORY.md for details of what changed in Parsoid since the previous release.
• Notable changes:
  • Parsoid HTML version is now 2.0.0
  • Support for content negotiation protocol for negotiating HTML content versions (see announcement)

This version of Parsoid will only work with versions of Visual Editor or Parsoid clients that request a Parsoid HTML version of 1.6.0 or later.

This version of Parsoid will only work with version 6 or later of Node.js. This version of Parsoid will probably not work with version 12 or later of Node.js.

0.9.0 (released Mar 23, 2018)

• Updated bundled parsoid to git commit 5fe6923ab
• See src/HISTORY.md for details of what changed in Parsoid since the previous release.
• Notable changes:
  • Parsoid HTML version is now 1.6.1
  • Sections are wrapped in <section> tags.

This is the last version of Parsoid with node v4 support.

IMPORTANT NOTICE:

This version of Parsoid will not work with versions of Visual Editor or Parsoid clients that request a Parsoid HTML version earlier than 1.6.0. If your Visual Editor code is newer than December 12, 2017, you are good. Otherwise, you will have to update your Visual Editor installation to a newer version.

Knowing this, you have a couple of options:

•  Not upgrade Parsoid: If you upgrade Parsoid without reading this notice and later stumble on this, you have the option of downgrading your Parsoid install by downloading an older deb package from https://releases.wikimedia.org/parsoid/

 Note: When using "apt" just issue apt-mark hold parsoid to prevent the upgrade of "parsoid".

• Upgrade VisualEditor as well as Parsoid: If you choose to upgrade Parsoid and your VisualEditor installation is from before Dec 12, 2017 (which is probably most of you), the recommended solution is to upgrade your VisualEditor installation as well; this will involve upgrading MediaWiki to 1.31.

If for some reason you really really need to upgrade Parsoid but cannot upgrade VisualEditor, contact us on IRC in #mediawiki-parsoid to ask us how you can do that.

0.8.1 (released June 5, 2018)

See src/HISTORY.md for details of what changed in Parsoid since the previous release.

This is a release to address security advisories and updates a couple of node modules from 0.8.0. This can be downloaded from https://releases.wikimedia.org/parsoid/

0.8.0 (released Oct 27, 2017)

See src/HISTORY.md for details of what changed in Parsoid since the previous release

Notable changes:

• Audio/video support
• Red links and disambiguation links marked up
• Support for improved TemplateData format specifier which lets templates control formatting of transclusions after VE edits

0.7.1 (released Apr 5, 2017)

The v0.7.0 release falsely claimed that nodejs v0.10 was still supported and didn't update the debian control file to update the nodejs dependency. This release fixes the dependency to require nodejs >= 4.0.0. This prevents users installing Parsoid v0.7.1 without upgrading nodejs to a >= v4.0.0 version.

0.7.0 (released Apr 4, 2017)

This is the last release with support for node 0.10. node v4 at minimum is now required. Wikimedia production version is using node v6.

The only notable change in this release is a native Parsoid implementation of the <gallery> extension. Besides that, there have been a number of bug fixes.

See src/HISTORY.md for details of what changed since the 0.6.1 release.

0.6.1 (released Nov 14, 2016)

0.6.1 is a release to replace the broken 0.6.0 debian package. Here are the major highlights since the 0.5.3 release.

There are two big changes in this package that might potentially be breaking changes for some installations.

1. In this upgrade, Parsoid has migrated to the service-runner npm package for providing the scaffolding for Parsoid's server.
   • service-runner expects a config.yaml file instead of a settings.js file. Parsoid's config.yaml file lets you use a settings.js file via the localsettings config option there.
   • This debian package automatically updates the config.yaml file to point to any pre-existing /etc/mediawiki/parsoid/settings.js file which should let you upgrade your Parsoid package without breaking your install.
2. The other big change is the removal of the previously deprecated v1/v2 APIs in Parsoid. This shouldn't affect you unless you have scripts that reference those APIs. Your VisualEditor installation *might* break if you haven't updated it recently if it were using these older APIs. If you installed or upgraded your VisualEditor installation in 2016, you are unlikely to be affected.

See src/HISTORY.md in the repository for more specific details of what changed in Parsoid since the 0.5.3 release.

0.5.3 (released Nov 1, 2016)

This is a security fix release of Parsoid and patches v0.5.1 with a fix for a reflected XSS security hole in the Parsoid API.

0.5.1 (released Jun 3, 2016)

This is the latest release of Parsoid and corresponds to v0.5.1 in the Parsoid repo. and v0.5.1 in the deploy repo. This version of Parsoid is compatible with the latest release of MediaWiki (1.27.0) and the related latest branch of VisualEditor, REL1_27. The debian package for it can be found here and installed via apt-get on debian systems.

Changes since 0.4.1

• Add v3 API to match RESTBase's API URL formats
• Lots of code cleanup + removal of dead code
• Parsoid code repository reorganized
• Keep data-* attributes at the edge of DOM
• Various performance fixes to handle pathological scenarios
• Added initial support for a Parsoid-native extension registration mechanism (undocumented and breaking changes expected till this is finalized)
• Added initial support for an autoload mechanism for extensions
• Lots of bug fixes

Note: v0.5.0 was a bad debian package and has been subsumed by v0.5.1.

0.4.1 (released Sep 17, 2015)

This is the previous released version of Parsoid and the debian package is no longer available in the mediawiki releases repository. Please upgrade to v0.5.1

0.4.0 (released Sep 2, 2015)

This version, while still available in the mediawiki releases repository, is slated to be removed shortly. Please upgrade to v0.5.1.