How to Add an Existing WordPress Website to WP Toolkit

Overview

A WordPress website installed manually or migrated from another server may not automatically appear in WP Toolkit. The Scan function can detect eligible installations within your cPanel account.

Scan for WordPress Installations

1. Log in to cPanel.
2. Open WP Toolkit.
3. Click Scan.
4. Wait for the scan to complete.
5. Review the detected installations.

A detected website should appear as a new installation card.

If the Website Is Not Detected

Confirm that:

• The WordPress files belong to the current cPanel account.
• The installation is inside a directory accessible to the account.
• The installation contains wp-config.php.
• wp-config.php contains correct database credentials.
• The WordPress database exists.
• File ownership and permissions are valid.
• WordPress core files are sufficiently complete.
• The website is not only a static copy without a functional database.
• The installation has not been marked as detached and blocked from future scans.

Verify the Detected Website

After the installation appears:

1. Confirm the displayed domain and path.
2. Open the public website.
3. Test Log in.
4. Review the detected WordPress version.
5. Check for available updates.
6. Review its backup and security status.

Do not immediately apply all updates to a newly detected or migrated website. Create a backup and review compatibility first.

Detach and Scan Again

Detaching an installation removes it from WP Toolkit management without deleting the website.

A detached installation may sometimes be added again by scanning, depending on how it was detached and the available interface options. If WP Toolkit offers an option to remove the installation from the list of ignored installations, use it before scanning again.