Parsoid/Parser Unification/Migration

In 2024, the Wikimedia Foundation changed the way HTML for browsers is generated. Now, Parsoid is used for this. In most cases, there should be no visible change. Parsoid is the next-generation software converting back and forth between HTML and wikitext. Wikitext is the markup language used by editors on Wikimedia projects.

FAQ

I can't close the notification dialog!

Click anywhere in the notification (except on the blue link) to dismiss it. We're working on improving this UX; suggestions welcome.

Something broke! Was it Parsoid's fault?

Go to Parsoid/Parser Unification/Known Issues.

How to opt-in/opt-out

Go to Help:Extension:ParserMigration.

I have more questions!

You can ask on the Known Issues discussion page, which we monitor, and you can also contact the Content Transform team via any of the mechanisms listed on our team page.

What has changed

In February 2024, some wikis began to use the new Parsoid wikitext parser for certain pages by default. A user notice informed readers the first time they encountered a page rendered with Parsoid, and at intervals afterward, directing them to this page for additional information. Any page rendered with Parsoid has a Use legacy parser link in the user tools sidebar allowing users to switch back to the old parser for that page in the event of any issues. In addition, the user preference added by the ParserMigration extension can be used to permanently opt-out of the use of Parsoid to render pages.

In November 2023 a user preference was added to allow individual users to opt-in to using the new Parsoid parser for all pages, using the ParserMigration extension.

All the steps described above are part of the Parser Unification project. Parsoid has been used for editing tasks since 2012.