← Back to main site

Troubleshooting Guide - GrabWP Tenancy

Installation Issues

Plugin Menu Not Showing

If the "Tenancy" menu doesn't appear in WordPress admin:

  1. Check wp-config.php Code
// GrabWP Tenancy - Early Loading
if ( file_exists( __DIR__ . '/wp-content/plugins/grabwp-tenancy/load.php' ) ) {
    require_once __DIR__ . '/wp-content/plugins/grabwp-tenancy/load.php';
}
  • Must be before "That's all, stop editing!"
  • Check file paths carefully
  • Verify no typos
  1. Check Plugin Folder
  • Must be named exactly "grabwp-tenancy"
  • Located in wp-content/plugins/
  • Contains all required files

File Errors

If you see "File not found" or PHP errors:

  1. Check Permissions
  • Files should be readable (644)
  • Folders should be executable (755)
  • WordPress needs write access
  1. Verify Installation
  • Reinstall plugin if needed
  • Check all files transferred
  • Verify wp-config.php syntax

Domain Issues

Invalid Domain Errors

When adding domains, avoid:

  • IP addresses (like 192.168.1.1)
  • localhost or test domains
  • Domains longer than 253 characters
  • Domains without proper format (like "test")
  • Special characters (only letters, numbers, hyphens)

Domain Already in Use

If you see "Domain already in use":

  • Check existing tenants
  • Each domain can only be used once
  • Remove domain from other tenant first
  • Try a different domain

Domain Not Working

If website doesn't load:

  1. Check DNS
  • Verify DNS points to your server
  • Wait for DNS propagation (5-30 minutes)
  • Use online DNS checker tools
  1. Check Hosting
  • Domain added to hosting panel
  • Points to WordPress directory
  • No conflicting configurations

Website Issues

Shows Wrong Content

If tenant shows main site content:

  1. Check Database
  • Tables should have tenant prefix
  • Like: abc123_posts, abc123_options
  • Deactivate and reactivate plugin
  1. Clear Caches
  • Browser cache
  • WordPress cache plugins
  • Hosting cache
  • CDN cache if used

Upload Problems

If media uploads fail:

  1. Check Directories
  • Verify uploads directory exists
  • Should be at: wp-content/uploads/grabwp-tenancy/[tenant-id]/uploads/
  • Check directory permissions
  1. Verify Settings
  • WordPress address settings
  • Upload path configurations
  • File permissions

Common Error Messages

"Please enter at least one domain"

  • Domain field empty
  • Enter valid domain name
  • Check format requirements

"Invalid domain format"

  • Use proper domain format
  • Example: example.com
  • Example: site.example.com

"Failed to create tenant"

  • Check file permissions
  • Verify WordPress has write access
  • Check error logs

"Tenant not found"

  • Verify tenant ID exists
  • Check database tables
  • Try recreating tenant

Getting Help

Check Error Logs

  1. Enable debugging in wp-config.php:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
  1. Check wp-content/debug.log

Contact Support

Include:

  • WordPress version
  • PHP version
  • Error messages
  • Steps you've tried
  • Debug log contents