Blank Page
Check PHP version, required extensions, storage/logs, and file permissions. Confirm APP_KEY exists. Enable debug only on private staging installs.
Common fixes
Troubleshooting
Use these notes to diagnose common hosting, installer, builder, route, database, email, forms, and blog comment issues.
Common Issues
404 On Routes
Confirm the document root points to public/. Enable Apache mod_rewrite or configure Nginx try_files.
Database Error
Verify database host, port, database name, username, password, and user privileges. For SQLite, confirm the file path exists and is writable.
Assets Not Loading
Run npm run build, confirm public/build exists, and verify APP_URL matches the correct domain and protocol.
Visual Builder Is Blank
Clear browser cache, run php artisan view:clear, confirm builder assets exist, and check the browser console for JavaScript errors.
Builder Does Not Publish Latest Changes
Use the current version where publish actions save first. If a browser has an old script cached, hard-refresh the builder page.
Shortcodes Cannot Be Selected
Shortcode tokens are selectable in the current builder scripts. Clear cached views and browser cache if old behavior remains.
Email Test Fails
Check SMTP host, port, encryption, username, password, provider app passwords, and hosting firewall restrictions on outbound SMTP.
IMAP Test Fails
Check IMAP host, port, encryption, credentials, and whether PHP IMAP is enabled on the server.
Comments Do Not Appear
Open /control/blog/comments. Comments may be pending, spam, or blocked depending on moderation settings.
Form Entries Missing
Confirm the form is active, embedded shortcode is correct, public route is reachable, CSRF is present, and the form fields match expected names.
Image Tools Fail
Enable GD and confirm media folders plus public/template-thumbnails are writable.