SearchAndHelp.com logo
Technology & Digital Life

How To Move WordPress To Root Directory

Staff Writer 8 min read

Many WordPress users initially install the platform in a subdirectory, such as yourdomain.com/wordpress or yourdomain.com/blog. While this setup can be convenient for testing or specific content strategies, there are compelling reasons why you might want to move WordPress to the root directory. Having your site at yourdomain.com directly often leads to cleaner URLs, better search engine optimization, and a more straightforward user experience.

Successfully moving your WordPress installation requires careful planning and execution to avoid potential downtime or broken links. This guide will provide step-by-step instructions, ensuring you can confidently move WordPress to the root directory, regardless of your current setup.

Why Move WordPress To Root Directory?

Understanding the benefits can motivate you to undertake this process. Moving your WordPress site directly to the main domain offers several advantages.

  • Cleaner URLs: Your website will be accessible directly at yourdomain.com instead of yourdomain.com/subdirectory, making URLs shorter and more memorable.

  • Improved SEO: Search engines often prefer content closer to the root domain. Cleaner URLs can potentially contribute to better search engine rankings and make your site appear more authoritative.

  • Easier Administration: Accessing your WordPress dashboard and files becomes more intuitive when the installation is in the root.

  • Enhanced User Experience: Visitors can type your domain name directly without remembering a subdirectory, leading to a smoother browsing experience.

Essential Preparations Before You Begin

Before you attempt to move WordPress to the root directory, it is absolutely critical to complete a few preparatory steps. These actions will safeguard your data and provide a fallback in case any issues arise during the process.

1. Create a Full Backup

This is the most important step. Before making any significant changes, create a complete backup of your WordPress files and database. You can use a WordPress backup plugin, your hosting provider’s backup tools, or manually back up via FTP and phpMyAdmin. Ensure your backup is stored in a safe, external location.

2. Access Your Hosting Control Panel and FTP Client

You will need access to your hosting account’s control panel (like cPanel or Plesk) and an FTP client (such as FileZilla). Ensure you have your login credentials handy for both, as you will be moving files and potentially editing configurations.

3. Understand Your Current Directory Structure

Familiarize yourself with where your WordPress installation currently resides. Typically, it’s in a folder named wordpress, blog, or similar, located within your public HTML directory (e.g., public_html or www).

Method 1: Moving WordPress Using Dashboard Settings (Recommended)

This method is generally preferred as it involves fewer direct file manipulations and leverages WordPress’s built-in settings. It’s ideal if you want your core WordPress files to remain in a subdirectory but have your site accessible from the root domain.

Step 1: Update WordPress Address Settings

Log in to your WordPress admin dashboard. Navigate to Settings > General. You will see two fields:

  • WordPress Address (URL): This is where your WordPress core files are located (e.g., http://yourdomain.com/wordpress).

  • Site Address (URL): This is the address people type to reach your site (e.g., http://yourdomain.com).

Change the Site Address (URL) to your root domain (e.g., http://yourdomain.com). Do not change the WordPress Address (URL) at this stage. Click Save Changes.

Step 2: Copy Index.php and .htaccess Files

Using your FTP client, navigate to the directory where your WordPress core files are located (e.g., /public_html/wordpress/). Select the index.php file and the .htaccess file. Copy these two files to your root directory (e.g., /public_html/).

If you cannot find the .htaccess file, ensure your FTP client is set to show hidden files.

Step 3: Edit the Index.php File

Open the index.php file that you just copied to your root directory using a text editor (you can download it via FTP, edit, and then re-upload, or use your hosting’s file manager). Find the following line:

require( dirname( __FILE__ ) . '/wp-blog-header.php' );

You need to change this line to point to the correct subdirectory where your WordPress core files still reside. For example, if your WordPress core files are in a folder named wordpress, you would change it to:

require( dirname( __FILE__ ) . '/wordpress/wp-blog-header.php' );

Save the changes and upload the modified index.php file back to your root directory, overwriting the existing one.

Step 4: Update Permalinks

Log back into your WordPress dashboard (you should now be able to access it via http://yourdomain.com/wp-admin). Go to Settings > Permalinks. Without making any changes, simply click the Save Changes button. This action regenerates your .htaccess file, ensuring it correctly points to the new site structure.

Step 5: Clear Caches and Test Your Site

If you are using any caching plugins, clear their caches. Then, thoroughly test your website. Check all pages, posts, images, and links to ensure everything is functioning correctly. Your site should now be accessible directly from your root domain.

Method 2: Physically Moving WordPress Core Files

This method involves moving all WordPress core files from the subdirectory to the root directory. This is often chosen for a completely clean root installation. Ensure you have a complete backup before proceeding.

Step 1: Update WordPress Address Settings

Log in to your WordPress admin dashboard. Go to Settings > General. Change both the WordPress Address (URL) and the Site Address (URL) to your root domain (e.g., http://yourdomain.com). Click Save Changes.

Warning: After saving, your site might appear broken, and you might lose access to the admin dashboard temporarily. This is expected, as WordPress is now looking for files in the root directory, but they haven’t been moved yet.

Step 2: Move All WordPress Files

Using your FTP client, navigate into your WordPress subdirectory (e.g., /public_html/wordpress/). Select all the files and folders within this directory. Drag and drop or copy them to your root directory (e.g., /public_html/).

This process can take some time, depending on the number of files and your internet connection speed.

Step 3: Verify and Clean Up (Optional)

Once all files are moved, check your root directory to ensure everything is there. You can now delete the empty WordPress subdirectory from your server, but only after confirming your site is working perfectly.

Step 4: Update Permalinks and Clear Cache

Access your WordPress dashboard via the new root URL (e.g., http://yourdomain.com/wp-admin). Navigate to Settings > Permalinks and click Save Changes. This refreshes your permalink structure. Clear any caching plugins you might be using.

Step 5: Update Database References (If Necessary)

In some cases, especially if you had hardcoded links or specific plugin configurations, you might need to update old URL references in your database. This can be done using a search-and-replace plugin like Better Search Replace or by running SQL queries directly via phpMyAdmin. Always back up your database before performing a search and replace.

Troubleshooting Common Issues

Even with careful steps, you might encounter issues when you move WordPress to the root directory. Here are some common problems and their solutions:

  • 404 Errors: This often indicates an issue with your .htaccess file or permalinks. Regenerate permalinks by going to Settings > Permalinks and clicking save. Ensure your .htaccess file has the correct permissions (usually 644).

  • Broken Images or CSS: This typically means media files or stylesheets are still pointing to the old subdirectory. Clear your browser cache and any server-side caching. If issues persist, check your database for old URL references and update them.

  • Redirect Loops: If your browser gets stuck in a redirect loop, check your .htaccess file for incorrect rewrite rules. Temporarily renaming your .htaccess file (e.g., to .htaccess_old) can help identify if it’s the cause. If so, generate a new one from WordPress permalink settings.

  • Cannot Access Admin Dashboard: If you’re locked out, you might need to manually reset your WordPress and Site URLs in the database via phpMyAdmin. Locate the wp_options table and edit the siteurl and home entries to your new root domain.

Conclusion

Moving WordPress to the root directory is a beneficial step for many website owners, leading to a cleaner, more SEO-friendly, and user-friendly site. By following the detailed methods outlined in this guide, you can confidently relocate your WordPress installation. Remember, the key to a successful migration lies in thorough preparation, especially creating a complete backup, and meticulously following each step. Once your site is successfully moved, perform extensive testing to ensure all functionalities are intact. Enjoy your streamlined WordPress presence on the root domain!