Fix cPanel’s WordPress Toolkit Not Detecting Site

This guide will explain how to fix an issue where when scanning for a WordPress site in cPanel the WordPress Toolkit interface doesn’t detect any sites, this is generally caused by a dot-file in the document root of the site that is added when a website is detached from WordPress Toolkit

TL;DR If WordPress Toolkit is not detecting any sites when scanning check for a .wp-toolkit-ignore file via cPanel > File Manager > Show Hidden Files > public_html > Right click on .wp-toolkit-ignore file and Delete


To complete this will require having a cPanel account with a WordPress site installed and when running a scan on WordPress Toolkit it is not detecting a WordPress site. To find out how to run a scan check out the following guide: How To Scan & Add a Site into cPanel’s WordPress Toolkit

How to check for a .wp-toolkit-ignore file preventing cPanel finding a website in WordPress Toolkit

Step-by-Step Guide

1/ Search for File Manager

In cPanel search for ‘File Manager’ in the top right search bar and click on File Manager from the search results

2/ File Manager Settings

Inside File Manager click on the settings cog in the top right corner

3/ Show Hidden Files

After opening the File Manager settings, tick the box for ‘Show Hidden Files’ and click OK

4/ Locate public_html

Locate the document root for the website, by default this is public_html. The document root can be found in cPanel > Domains. Right click on the .wp-toolkit-ignore file and click delete

5/ Delete .wp-toolkit-ignore file

On the following pop up confirm the deletion

Video Tutorial

Play Video


Now when running the scan for WordPress sites in cPanel’s WordPress Toolkit it will now detect the website