BugWP logo BugWP
Back to Community
Home / Community / Plugin → Classic editor

Troubleshooting Classic Editor Media Upload and Insertion Problems

28 threads Sep 7, 2025 Plugin → Classic editor

Content

Many WordPress users rely on the Classic Editor plugin for a familiar writing experience. However, a common and frustrating issue that can arise is the inability to upload or insert media files, such as images, into posts and pages. This guide will walk you through the most common causes and their solutions.

What Does the Problem Look Like?

The symptoms can vary, but users often report one or more of the following:

  • The "Add Media" button does nothing when clicked.
  • The media library modal opens, but selecting an image does not insert it into the editor.
  • Images in the media library appear as blank squares.
  • An error message appears in the browser's JavaScript console (e.g., 404, 403, or "TypeError").
  • An alert pops up stating "Something wrong occurred. Please try again."

Why Is This Happening?

It is crucial to understand that the Classic Editor plugin itself is rarely the root cause. It simply restores the old editing interface; the media uploading and handling functionality is all part of the core WordPress software. Therefore, problems are almost always due to one of the following:

  1. Plugin or Theme Conflicts: Another plugin or your current theme is causing a JavaScript error or interfering with the media upload process. This is the most frequent cause.
  2. Outdated Software: Running an old version of WordPress, PHP, or the Classic Editor plugin can lead to compatibility issues and bugs that have since been patched.
  3. Server Configuration: Security modules like ModSecurity might be blocking the AJAX requests necessary for the media library to function. File permission issues on the server can also prevent uploads.
  4. User Permissions (Multisite): On WordPress Multisite networks, only Super Admins have the "unfiltered_html" capability by default. If a user role like "Editor" cannot embed certain code, it is a permission setting, not a bug.

Step-by-Step Troubleshooting Guide

Step 1: Conflict Testing (The Most Important Step)

The first and most critical step is to determine if a plugin or theme is causing the conflict. The safest way to do this is by using the official Health Check plugin.

  1. Install and activate the Health Check plugin.
  2. Go to Tools > Site Health > Troubleshooting.
  3. Enable Troubleshooting Mode. This will temporarily disable all plugins and switch to a default theme (e.g., Twenty Twenty-Four) only for you, while your site remains normal for visitors.
  4. With only the Classic Editor plugin active, try to add media. Does it work now?
  5. If it works: The problem is a conflict. While still in Troubleshooting Mode, re-enable your plugins one by one, testing the media button after each, until you find the culprit. Finally, switch back to your theme to test it.
  6. If it does NOT work: The issue may lie with your WordPress core files, server configuration, or a outdated version of WordPress.

Step 2: Check for JavaScript Errors

Open your browser's developer console (usually F12) before clicking the "Add Media" button. Look for any red error messages. These can provide vital clues. For example, a "404" error on admin-ajax.php might point to a permalink or security issue, while a "TypeError" often indicates a script conflict.

Step 3: Update Everything

Ensure your WordPress installation, all plugins, and your theme are updated to their latest versions. Developers constantly release patches for known bugs and security issues. Also, confirm your server is running a supported version of PHP (7.4 or higher).

Step 4: Investigate Server-Side Issues

  • File Permissions: Incorrect file permissions on the /wp-content/ directory can prevent uploads. Generally, directories should be 755 and files should be 644.
  • ModSecurity: If you have access to your server's error logs (e.g., in cPanel), check for blocks from the ModSecurity firewall. A rule blocking a request to admin-ajax.php is a common culprit. Your hosting provider may need to whitelist the specific rule.
  • Memory Limits: Increase the PHP memory limit in your wp-config.php file by adding define('WP_MEMORY_LIMIT', '256M');.

Step 5: Multisite User Permissions

If users on a Multisite network cannot paste embed code, this is typically a security feature, not a bug. Only Super Admins can publish "unfiltered HTML." For other user roles, try pasting just the URL (e.g., a Facebook video link) and let WordPress handle the embed automatically, which is more secure and reliable.

Conclusion

Problems with adding media in the Classic Editor are almost never the fault of the plugin itself. By methodically testing for conflicts with the Health Check plugin, updating your software, and checking for server-side errors, you can almost always identify and resolve the underlying issue. Remember, a clean and updated WordPress environment is the key to a smoothly functioning editor.

Related Support Threads Support