Troubleshooting
Solve Common Issues – This guide will help you troubleshoot and resolve common problems with SinceCode Booking. Follow the steps carefully, and if you continue to experience issues, please contact our support team.
💡 Before You Start
Make sure you’re running the latest version of SinceCode Booking and that your WordPress installation is up to date. Many issues are resolved by simply updating to the latest version.
Booking Form Issues
❌ Problem: Booking form not displaying on my page
Possible Solutions:
- Check the shortcode: Make sure you’re using the correct shortcode:
[scb_booking_form] - Clear your cache: If using a caching plugin, clear all cache and try again
- Check for JavaScript errors: Open browser console (F12) and look for error messages
- Test with default theme: Temporarily switch to a default WordPress theme to rule out theme conflicts
- Disable other plugins: Deactivate other plugins one by one to identify conflicts
❌ Problem: Booking form shows but doesn’t accept submissions
Possible Solutions:
- Check business hours: Ensure your business hours are properly configured in Settings → Hours & Closures
- Verify staff availability: Make sure at least one staff member has working hours set
- Check services: Confirm you have at least one active service created
- Review browser console: Check for JavaScript errors that might be blocking form submission
❌ Problem: Customers can’t select any available time slots
Possible Solutions:
- Verify business hours: Check Settings → Hours & Closures to ensure hours are set correctly
- Check staff schedules: Make sure staff working hours don’t conflict with business hours
- Review Max Days Ahead: In Settings → General, ensure this value allows future bookings
- Check for closures: Remove any accidental holiday closures that might block dates
Email Notification Issues
❌ Problem: Emails not being sent to customers or admins
Possible Solutions:
- Check email addresses: Verify all email addresses are entered correctly in Settings → Notifications
- Test SMTP connection: If using SMTP, click “Test SMTP Connection” to verify settings
- Check spam folders: Emails might be marked as spam – check junk/spam folders
- Enable SMTP: WordPress default mail often fails – use SMTP for reliable delivery
- Verify SMTP settings: Double-check host, port, username, and password
- Check “From Email”: Must match your SMTP account/domain
💡 SMTP Help
Consult your email provider’s documentation for specific SMTP settings. Popular providers like Gmail, Office 365, and others have detailed setup guides available.
❌ Problem: Emails going to spam
Possible Solutions:
- Use authenticated SMTP: Enable SMTP in Settings → Notifications with proper credentials
- Configure SPF records: Add SPF record to your domain’s DNS settings
- Set up DKIM: Enable DKIM authentication with your email provider
- Use matching domain: Send emails from an address that matches your website domain
- Avoid spam trigger words: Review email templates for spam-like content
SMS Notification Issues (Pro)
❌ Problem: SMS notifications not being sent
Possible Solutions:
- Verify Pro plan: SMS notifications require an active Pro plan subscription
- Enable SMS: Check that “Enable Email-to-SMS” is turned on in Settings → Notifications
- Check phone numbers: Ensure customer phone numbers are in correct format
- Review consent settings: If SMS consent is required, verify customers have opted in
- Verify SMS events: Check that SMS events (Booking Created, Accepted, etc.) are enabled
Schedule & Availability Issues
❌ Problem: Staff member not showing up in booking form
Possible Solutions:
- Check staff status: Ensure the staff member is published/active
- Verify working hours: Staff must have at least one day with working hours set
- Check service assignment: Staff must be assigned to at least one service
- Review business hours: Staff hours must fall within business operating hours
❌ Problem: Can’t change business hours – conflict errors
Possible Solutions:
- Schedule for future date: Use the conflict detection system to schedule changes for a future date
- Cancel conflicting bookings: Reject or reschedule bookings that fall outside new hours
- Adjust staff schedules first: Update individual staff hours before changing business hours
❌ Problem: Holidays not blocking bookings
Possible Solutions:
- Save your changes: Click “Save Business Hours” after adding holidays
- Check closure dates: Verify dates are entered correctly
- “Closed” checkbox: Ensure the “Closed” option is checked for full-day closures
- Clear cache: If using caching, clear all cache after making changes
Display & Styling Issues
❌ Problem: Booking form looks broken or unstyled
Possible Solutions:
- Clear all caches: Clear browser cache, WordPress cache, and CDN cache
- Check for CSS conflicts: Your theme or another plugin may be overriding styles
- Test with default theme: Switch to a default WordPress theme to isolate the issue
- Review customization settings: Check Settings → Customise for any problematic custom styles
❌ Problem: Shortcodes displaying as text instead of content
Possible Solutions:
- Check shortcode syntax: Ensure square brackets are correct:
[scb_booking_form] - Verify plugin is active: Make sure SinceCode Booking is activated
- Use text editor: Switch to text/HTML mode when pasting shortcodes
- Check for smart quotes: Ensure straight quotes, not curly quotes in shortcode parameters
Pro Feature Issues
❌ Problem: Pro features not working after upgrade
Possible Solutions:
- Verify license activation: Check that your Pro license is properly activated
- Check subscription status: Ensure your Pro subscription is active and not expired
- Clear cache: Clear all caches after upgrading
- Contact support: If issues persist, contact support with your license information
❌ Problem: Can’t add more than 5 services
Solution:
The Free plan is limited to 5 services. To add more services, you’ll need to upgrade to the Pro plan. Click the Upgrade button in the sidebar menu to get unlimited services and other Pro features.
Performance Issues
❌ Problem: Booking form loading slowly
Possible Solutions:
- Enable caching: Use a caching plugin to improve load times
- Optimize images: Compress staff photos and company logo
- Check hosting: Ensure your hosting plan has adequate resources
- Limit plugins: Deactivate unnecessary plugins that may slow down your site
- Use a CDN: Consider using a Content Delivery Network for faster asset loading
🆘 Still Having Issues?
If you’ve tried these solutions and are still experiencing problems:
- Check the Documentation – Review relevant guides for detailed setup instructions
- Visit the Support Forum – Search for similar issues or ask the community
- Contact Support – Reach out to our support team with:
- A detailed description of the problem
- Steps you’ve already tried
- Screenshots of any error messages
- Your WordPress and plugin versions
Pro plan users receive priority support with faster response times!
Prevention Tips
Avoid common issues by following these best practices:
- ✓ Keep WordPress, theme, and all plugins updated
- ✓ Regular backups before making major changes
- ✓ Test changes on a staging site first
- ✓ Clear cache after configuration changes
- ✓ Use quality hosting with adequate resources
- ✓ Review documentation before configuring new features
- ✓ Monitor email deliverability regularly