Support » Fixing WordPress » Read this FIRST! WordPress 5.9

  • Moderator Steven Stern (sterndata)


    Forum Moderator & Support Team Rep

    [ Troubleshooting | Reported theme or plugin issues | Reporting a WordPress bug ]

    So you’ve just updated to WordPress 5.9 “Josephine”! But what’s this? Something broke? Or maybe you just have some questions you want to ask? This will help guide you through both troubleshooting, and common questions after the new update.

    If your site broke, don’t panic!

    Before you go any further, make sure you’ve updated your plugins and themes to the latest versions, clear your browser’s cache and cookies and re-log in to your WordPress dashboard.

    Still having problems? Okay, read on!

    This thread contains the known issues with plugins and themes found in the latest release. Please read this WHOLE topic and come back and check again later, as it will be updated.

    Remember to be calm, be patient, and be respectful. Volunteers are out here to try and help you, but we need your help too. All of the normal forum rules still apply. Remember, you are just as important as everyone else.

    If your post doesn’t show up right away, please be patient. With the higher than normal post volume, more posts get flagged as spam by our auto-spam tool. We’re working hard to keep the queue clear, but making multiple posts slows us down, as we have to go back and check if you already posted. Post once.

    • Do use proper capitalization in post titles and body. Punctuate your sentence properly and humanely, it helps us read.
    • Do use descriptive subject lines. “All permalinks broken since 5.0” is much better than “Augh! Help ASAP! This version is terrible!”
    • Do describe the problem clearly. Explain what you’re seeing, include error messages and link to screenshots if needed. Linking to your site, if the problem is on the front-end, also helps.
    • Do be patient. We know it sucks to be down, but posting multiple times doesn’t get you help any faster.
    • Do make your own topic unless you are using the exact same version of WordPress on the same physical server hosted by the same hosts with the same plugins, theme and configurations as the original poster. You may find it weird, but it will be easier for us to help you specifically if you have your own topic.
    • Do mark your topic as resolved when it’s fixed so we know not to come looking there anymore.
    • Do remember you’re not alone.

    Also keep in mind that not liking the direction of WordPress’s design is not a bug. If you don’t like a feature, please don’t make a series of posts complaining about it. Look and see if someone already did, and post there, or consider joining the process earlier on (like in Beta or even test via SVN). What you’re seeing today is the result of thousands of hours of work and testing, and unless something is outright broken, it’s highly unlikely to be changed.

    Again, before you post:

    Make sure you’ve read this entire thread and New Features in 5.9 Article.

    Go to your own install’s about page – (or click the WordPress logo in the top corner) – to see what’s new.

    Still having problems after going through the troubleshooting steps below? Please feel free to ask your question here in the support forums.

Viewing 3 replies - 1 through 3 (of 3 total)
  • Moderator Steven Stern (sterndata)


    Forum Moderator & Support Team Rep

    What’s New in 5.9?

    Have you read the WordPress 5.9 Field Guide yet? hint hint

    What happened to the Customizer?

    Site Editor & Customizer

    It is only available to content creators who are using a Block theme. When you are using the Site Editor, most changes here are made across your entire site.

    Features that become part of the Site Editor may disable parts of the customizer.


    Block Themes

    A Block Theme is a theme that uses blocks for all parts of a site, including navigation menus, header, content, and site footer.


    Customize your site as much as you’d like with different colors, typography, layouts, and more via the Styles side panel


    The Template Part block is an advanced block introduced in WordPress 5.9 that can be used with a block theme or a theme that supports template editing.


    Already available in WordPress 5.8 and enhanced in 5.9 – The Template Editor is a feature that allows block editor users to edit and create templates that a page or posts uses.


    Various dimension controls are built into different blocks to help you achieve greater customization for your layout and design.


    Props to Birgit Pauli-Haack for a lot of the text and links.

    Moderator Steven Stern (sterndata)


    Forum Moderator & Support Team Rep


    Before posting, please make sure you’ve tried started by performing the troubleshooting steps outlined below:

    • Flushing any caching plugins you might be running, as well as server and/or browser caches. Not just your browser, but any op cache or content network cache as well such as Cloudflare. That will solve many weird JavaScript issues.
    • Flushing Managed host caches. Managed WP hosting often has special caches. If your host has a “Purge Varnish” or “Flush Memcache” tool, try that. You can ask your provider to flush memcache and Varnish for you if necessary.
    • Resave your Permalink settings. In a few cases, we’ve seen third-party installers, such as Softaculous, creating sites with slightly incorrect rules in the .htaccess file. While these rules would not have been a problem in previous versions, having these incorrect rules can break the REST API in newer versions. Resaving the permalinks on the Settings->Permalinks page in WordPress will fix these rules in the .htaccess file, and possibly fix “failed” errors in the new editor.
    • Troubleshooting with your browser. Your browser can help you identify JavaScript issues or conflicts and this article can assist you in doing that diagnosis. This could help identify Visual Editor issues as well.
    • Make sure you have the Visual Editor enabled. Visit your Users->Your Profile page. The first option will disable the visual editor. Make sure that option is unchecked, and save your profile settings.
    • Deactivating all plugins (yes, all) to see if this resolves the problem. If this works, re-activate the plugins one by one until you find the problematic plugin(s). If you can’t get into your admin dashboard, try resetting the plugins folder by SFTP/FTP or PhpMyAdmin (read “How to deactivate all plugins when you can’t log in to wp-admin” if you need help). Sometimes, an apparently inactive plugin can still cause problems. Also remember to deactivate any plugins in the mu-plugins folder. The easiest way is to rename that folder to mu-plugins-old
    • If you can install plugins, install “Health Check”: On the troubleshooting tab, you can click the button to disable all plugins and change the theme for you, while you’re still logged in, without affecting normal visitors to your site.
    • Switching to the Twenty Twenty One theme to rule out any theme-specific problems. If you can’t log in to change themes, you can remove the theme folders via SFTP/FTP so the only one is twentytwentyone. That will force your site to use it.
    • Manually upgrading. When all else fails, download a fresh copy of the file for this release (top right on this page) to your computer, and use that to copy up. You may need to delete the wp-admin and wp-includes folders on your server (NOTE: do not delete the wp-content directory or your wp-config.php file) Read the Manual Update directions first.

    If your problem persists, and is related to elements no longer working as expected, for example a slider, a datepicker, a button, you may be experiencing issues with the JavaScript library called jQuery. Please try the Enable jQuery Migrate Helper plugin and se if it remedies your problems.

    If you need to create a support topic, you can provide debug data for the support volunteers by visiting the Site Health section under Tools > Site Health > Info.

    Moderator Steven Stern (sterndata)


    Forum Moderator & Support Team Rep

    Known Issues:

    Media Gallery:

      Drag-and-drop in the Media Library’s overlay for editing a gallery does not work in WP 5.9 but did in 5.8.3.
      This is caused by a regression in the jQuery UI Sortable library, a fix has been released for the library, and will be included in the upcoming release of WordPress 5.9.1

      Fixed in 5.9.1

    Gutenberg (plugin) related:

      WP 5.9 update causes fatals for a handful of sites:

      PHP Fatal error: Cannot declare interface WP_Theme_JSON_Schema, because the name is already in use in /path/to/wordpress/wp-content/plugins/gutenberg/lib/interface-wp-theme-json-schema.php on line 13

      This occurs if the Gutenberg plugin is installed and is below version 11.8.2.

      Fixed in 5.9.1

Viewing 3 replies - 1 through 3 (of 3 total)
  • The topic ‘Read this FIRST! WordPress 5.9’ is closed to new replies.