Possible Installation Issues

Last Update: October 13, 2026

Installing a WordPress theme is usually straightforward, but server settings, file limitations, or configuration issues can sometimes get in the way. When an installation doesn’t go as planned, understanding the most common causes can save you time and frustration.

This troubleshooting guide covers the typical WordPress and Avada installation problems users encounter and explains how to resolve them, helping you get your site set up quickly and with confidence.

Installation Error: Destination Folder Already Exists

If you are seeing this error message when installing Avada, you have 3 options to choose from:

Option 1: Delete Avada from Appearance > Themes in WordPress, then upload the new zip file.

Option 2: Access your site via FTP or cPanel. Rename the old Avada folder in wp-content/themes to something like AvadaOld, then upload the new version either as a zip through your Dashboard or unzipped into the themes folder through FTP. This option lets you keep the old theme version as a backup on your installation in case you want to switch back. Note: It is always recommended that the version you will finally use is in a folder called Avada.

Option 3: Access your site through FTP or cPanel and navigate to wp-content > Themes. Delete the old Avada folder, upload the new version either as a zip through your Dashboard or unzipped into the themes folder through FTP.

White Screen After Installing Avada

  • Did you recently upgrade your version of WordPress, and did you check to see if the white screen occurred before you installed and activated Avada?
  • Did you install any plugins prior to installing Avada?

If you upload Avada and activate it, and see nothing but a white screen, please read the following information. This is more common than you might think, and it can be frustrating to sort out. Firstly, it is important to understand what the white screen, often referred to as the “white screen of death,” actually means. Simply put, there is an error that you can’t see. The reason you can’t see it is because WordPress is not displaying the error that is causing the problem. When attempting to diagnose a white screen condition, consider what you did before the condition occurred:

Debug Mode

One way to diagnose the issue without simply guessing is to turn debug mode on in WordPress. This helps you see the actual error. In your wp-config.php file, change this:

Copy to Clipboard

to:

Copy to Clipboard

Now reload the page. Instead of a white screen, you’ll likely see a PHP error message. That message tells you exactly what’s wrong.

Plugins

Now let’s go through the likely cadidates. Plugins are high on the list. No matter how hard developers try, it is basically impossible to write plugins that will work and play well together with every single theme out there. The same is true in reverse. If you experience a white screen after activating Avada, the problem could be a plugin that is in conflict with it. Try the following:

  • If you can access the admin area of your site, but get the white screen on the front end, login to your admin section and deactivate all plugins. After doing so, check your front end page again. If you can see it, you have a plugin conflict. Now, start activating each plugin one by one. When you see the white screen again on the front end pages, you will know that the last plugin you activated is the likely culprit. Deactivate it and continue checking all remaining plugins one by one to make sure there are no others.
  • If you are getting the white screen on the front end and the back end admin area, then you will need to access your site via an FTP client. A little known trick is to change the name of your /wp-content/plugins folder to something else temporarily like “plugins.bak.” This will make WordPress ignore your plugins. Then check to see if this resolves the problem. If it does, log into your admin section and then change your plugin.bak folder back to plugins. Then deactivate all of your plugins via your admin page.

PHP Version

Sometimes, it’s simply a PHP version that is too low. Avada requires a modern PHP version.

The recommended version of PHP for Avada is 8.3 or higher.

If you’re on something like PHP 7.2 or lower, this alone can cause a white screen. To fix this, simply update the PHP version in your hosting control panel (cPanel, Plesk, etc.)

Themes

The most likely issue associated with a theme being the cause of a white screen condition is when the upload of the theme did not complete the transfer of all files, the transfer resulted in corrupted theme files, or you have PHP configuration memory limits set too low. Try this:

  • If you can access your admin area, disable all plugins as described above, change to one of the WordPress default themes. Check to see if this resolves the problem. If it does, try reinstalling the Avada by completely removing the old copy in /wp-content/themes/ and installing a fresh copy. We recommend using FTP to do this because you less likely to run into errors than when you use HTTP WordPress theme installer. Activate the replacement copy of Avada and see if the white screen condition returns.

  • If you cannot access your admin area, use an FTP client to access your site. Disable your plugins by following step #2 in the plugins instructions above, and delete Avada entirely. This will force WordPress to use the default WordPress theme. See if the problem persists. If it does, then the problem is likely in your WordPress installation. If the problem does not occur, then install a fresh copy of Avada via FTP, activate it, and see if the problem reappears.

System Status

  • You may also be suffering from a web server configuration that is set with PHP memory limits too low. If this is the case, it can cause the white screen condition as well. Check the System Status page for confirmation of this. You can then ask your web hosting service to increase your PHP memory_limit to at least 64 megabytes. 128 megabytes is recommended.

Other Causes

  • Blank space in functions.php – This is easy to do if you’ve been modifying the file. A good way to check is to replace it with the unchanged version of the file and see if the site works.
  • Blank line in wp-config.php – a blank line at the start of this file can bring on the White Death. Check for extra spaces at the end as well.
  • File Permissions – Make sure all the directories are set with permission of 755 and the other files 644. This should not happen because the server should inherit the permissions of the files that get uploaded to the server. But we have seen occurrences where, for example, unpacking a ZIP archive using CPANEL and other interface tools botched permissions.
  • Multiple Plugins – When you’re reactivating your plugins, the first one you find that causes the problem may not be the only one. Sometimes its a combination of two or more. So you may think you have the problem solved, but it may still exist and come back in the future.

The following is a list of possible other causes for the white screen condition, because they too can cause this error:

Tips

  • Check your error logs. A good amount of the time, server logs will show *exactly* what PHP function is causing the issue, and where.

  • Run a PHP validator on the code prior to saving. It will catch a lot of simple mistakes.

Custom Permalinks Return 404 Errors

If your pages return a 404 Page Not Found error after enabling custom permalinks in WordPress, the issue is typically related to your WordPress or server configuration — not Avada itself.

Common Symptoms

“I just setup my WordPress installation and my awesome new Avada Website. I went into WP Admin > Settings > Permalinks and selected something other than the default option. But now when I try and navigate to a page, it just returns a generic ‘404 Error – Page not found’ message. What gives?”

Common Causes

Firstly, this is not an Avada issue. The problem involves your core WordPress installation, or your web server configuration. There a few things that can cause this to happen:

  • The server rewrite module is not enabled (for Apache servers, this is usually mod_rewrite)
  • The .htaccess file is missing or not writable
  • Apache II is configured to disallow overrides by your .htaccess file.
  • Rewrite rules have not been refreshed correctly
  • A permalink slug conflict exists

How To Fix It

There are several solutions to this issue. Please see the list below.

  • 1. Reset Your Permalinks. The simplest fix is often to refresh the rewrite rules. Go to Settings > Permalinks. Select your preferred permalink structure. Click Save Changes. If needed, switch temporarily to Plain, save, then switch back and save again.

  • 2. Check Your .htaccess File. Make sure a .htaccess file exists in the root of your WordPress installation. If it doesn’t exist: Create a blank file named .htaccess, and upload it to your WordPress root directory. Also ensure the file is writable by the server so WordPress can update rewrite rules automatically.

  • 3. Verify Server Rewrite Support. On Apache servers, ensure: mod_rewrite is enabled and htaccess overrides are allowed (AllowOverride All). If you’re unsure, contact your hosting provider for assistance.

  • 4. Add Rewrite Rules Manually. If WordPress cannot write to .htaccess, you’ll see rewrite rules displayed on the Permalinks page after saving. Copy those rules into your .htaccess file manually and upload the file back to the server.

  • 5. Check for Slug Conflicts. 404 errors can also happen when multiple pages, post types, or plugins use the same permalink slug. For example: /blog/, /portfolio/ or /events/. Try changing conflicting slugs and then resave your permalinks.

  • 6. Clear All Cache. After making changes, clear all forms of cache, including: Browser cache, Caching plugins & Server or CDN cache.

Still Having Issues?

If the problem persists after following the steps above, contact your hosting provider to check your server configuration.

Are you sure you want to do this? Please try again.

If you are installing Avada One in WordPress but get a message that says “Are you sure you want to do this?”, the most likely reason is that your web server is configured with low PHP settings that only allow a limited ZIP file size to be uploaded via the WordPress Dashboard.

Some hosting companies configure their servers to limit file uploads to ~10 MB; some set even lower limits. The Avada One ZIP file is about 20MB. If you get this error, your web server is rejecting the upload because the AvadaOne.zip file is too large. WordPress is unfortunately giving you a rather ambiguous message in response. This is not an Avada issue or a bug.

Ways To Fix The Issue

  • Request that your web host increase your PHP limits so a larger ZIP file can be uploaded. They will know which limits to set if you explain the issue.
  • You can upload your Avada files via FTP. View this tutorial video for more information.

Recommended PHP Configuration Limits

  • max_execution_time 180

  • memory_limit 128M
  • post_max_size 32M

  • upload_max_filesize 32M

Other Errors

  • Uploading the wrong ZIP file: Make sure you upload only the installable theme ZIP. If you downloaded a full package from a marketplace, unzip it first, then upload the theme-specific ZIP file inside.
  • File size upload limits too low: Increase the maximum upload size through your hosting control panel, PHP settings, or by editing php.ini, .htaccess, or wp-config.php. If that’s not possible, install the theme via FTP.
  • PHP memory limit or time limit errors: Raise the PHP memory limit and max execution time through your server settings or hosting panel. Many themes require higher limits to install and run properly.

  • “Missing stylesheet.css” error: This usually means the wrong file was uploaded. Double-check that the ZIP contains a style.css file at its root and that you’re uploading the actual theme, not a documentation or package folder.

  • Insufficient file permissions: Ensure your wp-content, themes, and uploads folders have correct permissions (typically 755 for folders and 644 for files). Your host can help adjust these if needed.

  • Server timeouts or white screen during install: Increase PHP time limits and memory, disable other plugins temporarily, and try installing the theme via FTP to avoid browser-based timeouts.

  • Incompatible PHP version: Check the theme’s recommended PHP version and update or switch to a supported release in your web hosting control panel.

  • Plugin dependency issues: Install and activate required plugins one at a time. If a plugin fails, verify PHP limits and version compatibility, then retry or install it manually.

  • Corrupt or incomplete downloads: Re-download the theme from the original source to ensure all files are intact, then upload again using a stable internet connection.

  • Security or firewall restrictions blocking uploads: Temporarily disable security plugins, server firewalls, or mod_security rules during installation, then re-enable them once the theme is installed.

In this article

Go to Top