Recently, a user on one of our managed WordPress sites encountered the 'Add Media' button suddenly failing in the editor. No error messages appeared, leaving them puzzled. As experienced WordPress administrators, we've resolved this for countless sites. In this guide, we'll walk you through proven fixes for the 'Add Media' button not working in WordPress.
This issue typically stems from JavaScript conflicts caused by plugins or themes loading incompatible scripts or stylesheets. WordPress normally concatenates these assets in the admin area to boost performance. However, a faulty script can break the post editor's JavaScript, disabling buttons like 'Add Media'.
Let's dive into troubleshooting and fixing this step by step.
For an immediate resolution, add this line to your wp-config.php file, just before the 'That's all, stop editing! Happy publishing.' line:
define('CONCATENATE_SCRIPTS', false);This disables script concatenation, loading files individually to sidestep conflicts with buggy code. Head back to your post editor afterward—the button should work.
Important: This is a temporary workaround. The root cause persists, so use your browser's developer console (F12 > Console tab) to spot errors pointing to the culprit.
For a permanent solution, follow standard WordPress troubleshooting—ideally on a staging site to avoid live disruptions. Top hosts like Bluehost, SiteGround, WP Engine, and Liquid Web offer one-click staging. See our staging guide here.
On staging: Deactivate all plugins and test the 'Add Media' button. If fixed, reactivate one by one to isolate the offender.
Replace the faulty plugin or contact its developer. If plugins aren't the issue, switch to a default theme like Twenty Twenty-Four.
If the default theme resolves it, your theme is conflicting—reach out to its author or choose a reliable alternative.
Apply the fix to your live site once identified. We hope this helped restore your 'Add Media' button. Check our complete list of common WordPress errors for more.
Subscribe to our YouTube channel for video tutorials, and follow us on Twitter and Facebook for tips.