Troubleshooting Guide
Solutions to common issues with SkunkPages. Can't find what you need? Contact support.
🚨 Try These First
Before diving into specific issues, try these quick fixes that solve 80% of problems:
- 1.Clear all caches - Browser cache, WordPress cache, hosting cache, CDN cache
- 2.Hard refresh - Press Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
- 3.Test for conflicts - Deactivate other plugins one by one
- 4.Update everything - WordPress, theme, and all plugins
- 5.Check console - Open browser dev tools (F12) and check for errors
Installation Issues
❌ Blocks not appearing in WordPress editor
Solutions:
- ✓Clear your browser cache and refresh the page
- ✓Ensure you're using WordPress 5.8 or higher
- ✓Check if block editor is enabled (not Classic Editor)
- ✓Deactivate other block plugins temporarily to test for conflicts
- ✓Re-save your permalinks: Settings → Permalinks → Save Changes
❌ Plugin won't activate
Solutions:
- ✓Check PHP version is 7.4 or higher
- ✓Ensure WordPress version is 5.8+
- ✓Check for plugin conflicts by deactivating other plugins
- ✓Contact your hosting provider about server requirements
❌ White screen after activation
Solutions:
- ✓Increase PHP memory limit to 256MB or higher
- ✓Check error logs in cPanel or hosting dashboard
- ✓Contact hosting support to check server error logs
- ✓Try accessing site in incognito/private mode
Styling Issues
❌ Blocks look broken or unstyled
Solutions:
- ✓Clear all caching (browser, WordPress, CDN, hosting)
- ✓Check if your theme has CSS conflicts
- ✓Temporarily switch to a default WordPress theme to test
- ✓Ensure no CSS is overriding SkunkPages styles
- ✓Check browser console for JavaScript errors
❌ Custom colors not applying
Solutions:
- ✓Clear browser cache and hard refresh (Ctrl+F5 or Cmd+Shift+R)
- ✓Check if theme has !important CSS overrides
- ✓Save the page/post after making color changes
- ✓Use browser inspector to check if colors are being applied
❌ Mobile layout looks wrong
Solutions:
- ✓Clear mobile cache
- ✓Test in actual mobile browser, not just responsive mode
- ✓Check if theme has conflicting mobile styles
- ✓Ensure viewport meta tag is present in theme
Performance Issues
❌ Page loads slowly
Solutions:
- ✓Optimize and compress images before uploading
- ✓Use an image optimization plugin
- ✓Enable caching plugin (WP Rocket, W3 Total Cache)
- ✓Use a CDN for faster asset delivery
- ✓Check hosting performance and upgrade if needed
❌ Editor is laggy
Solutions:
- ✓Close unused browser tabs
- ✓Disable browser extensions temporarily
- ✓Clear WordPress transients and cache
- ✓Check if other plugins are slowing down the editor
- ✓Use a more powerful hosting plan
Functionality Issues
❌ Forms not submitting
Solutions:
- ✓Check if form action/endpoint is configured
- ✓Verify email settings in WordPress
- ✓Test with a different email address
- ✓Check spam folder for form submissions
- ✓Ensure hosting allows mail() function
❌ Links not working
Solutions:
- ✓Check if URLs are properly formatted (include https://)
- ✓Ensure internal links use relative paths
- ✓Test links in different browsers
- ✓Clear cache and test again
❌ Images not displaying
Solutions:
- ✓Check image file size (should be under 2MB)
- ✓Verify image is uploaded to Media Library
- ✓Test with a different image format (JPG, PNG)
- ✓Check file permissions on uploads folder
- ✓Ensure CDN settings aren't blocking images
Theme Conflicts
❌ Theme overriding SkunkPages styles
Solutions:
- ✓Add custom CSS to increase specificity
- ✓Use the "Additional CSS" feature in WordPress Customizer
- ✓Contact theme author about compatibility
- ✓Consider switching to a more minimal theme
❌ Header/footer from theme showing
Solutions:
- ✓Use a blank page template if your theme provides one
- ✓Install a blank template plugin
- ✓Hide theme header/footer with custom CSS
- ✓Use Elementor or similar page builder's blank template
💻 System Requirements
Ensure your server meets these minimum requirements:
Minimum Requirements
- •WordPress 5.8+
- •PHP 7.4+
- •MySQL 5.6+
- •256MB PHP Memory
Recommended
- ✓WordPress 6.0+
- ✓PHP 8.0+
- ✓MySQL 8.0+
- ✓512MB+ PHP Memory
Still Need Help?
Our support team is here to help you succeed with SkunkPages.
🔍 Enabling Debug Mode
When reporting issues, it helps to enable WordPress debug mode. Add this to your wp-config.php:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
This will log errors to wp-content/debug.log which you can send to support.