Overview
This article covers common WP Toolkit problems for regular cPanel users and explains when to contact hosting support or a website developer.
WP Toolkit Is Not Displayed
Possible causes include:
- WP Toolkit is not enabled for the hosting package.
- Your cPanel account does not have the required feature.
- The server or hosting plan does not support it.
- Your access permissions are limited.
Contact hosting support to confirm availability.
A WordPress Website Is Missing
- Click Scan.
- Confirm that WordPress files exist in the correct account.
- Verify that
wp-config.phpexists. - Confirm the database exists.
- Check the database information in
wp-config.php. - Confirm valid file ownership and permissions.
- Verify that the installation was not detached and ignored.
One-Click Login Does Not Work
Check whether:
- The website URL is correct.
- WordPress files are accessible.
- The database connection works.
- A security plugin changed the login URL.
- Redirects are incorrect.
- The website forces an invalid domain or protocol.
- WordPress core files are incomplete.
- Browser cookies or a security rule interfere with the session.
Try accessing:
If direct login works but one-click login does not, contact hosting support with the exact error and time.
An Update Fails
- Confirm that a recent backup exists.
- Check disk space and inode usage.
- Review WP Toolkit and WordPress logs.
- Confirm PHP compatibility.
- Update one component at a time.
- Check file permissions.
- Temporarily clear or disable caching when appropriate.
- Retry only after identifying the likely cause.
The Website Fails After an Update
- Stop applying additional updates.
- Clear relevant caches.
- Review the error and debug logs.
- Deactivate the suspected plugin or theme.
- Switch to a current default theme if necessary.
- Restore the most recent working backup when appropriate.
- Contact the website developer for compatibility or custom-code problems.
Backup Fails
Check:
- Available disk space
- Available inodes
- File permissions
- Database connectivity
- The size of the website
- Existing incomplete backups
- The displayed WP Toolkit error
A backup may require temporary storage in addition to the final backup size.
Clone, Staging, or Copy Data Fails
Confirm that:
- The feature is included in your plan.
- The destination domain or subdomain exists.
- The destination directory is suitable.
- Sufficient disk space and inodes are available.
- The source database works.
- The destination does not contain conflicting files.
- File permissions are valid.
Maintenance Mode Remains Enabled
- Disable it from WP Toolkit.
- Clear the website and browser caches.
- Check whether a WordPress maintenance file remains.
- Confirm that a plugin has not enabled its own maintenance mode.
Contact support if WP Toolkit reports maintenance mode as disabled but the generated maintenance page remains.
Changes Do Not Appear
Clear:
- WordPress cache
- Caching-plugin data
- Browser cache
- CDN or proxy cache, if applicable
- Server-side cache, where available
Also verify that you are editing the correct production or staging installation.
When to Contact Hosting Support
Contact hosting support when the problem concerns:
- WP Toolkit availability
- A WP Toolkit interface or operation error
- Server permissions or ownership
- Account resource limits
- Backup infrastructure
- PHP availability
- A feature missing from the hosting package
- A website that WP Toolkit cannot detect despite a valid installation
Provide:
- Domain name
- Approximate time of the error
- Operation attempted
- Exact error message
- Screenshot, if available
- Whether a recent backup exists
Do not send passwords through a support ticket unless an approved secure method is provided.
When to Contact Your Website Developer
Contact the developer when the issue concerns:
- Custom code
- Plugin or theme compatibility
- Website design
- Checkout or business functions
- Database-content conflicts
- Staging deployment planning
- Third-party integrations
- Errors caused by application-level changes