Skip to main content

Troubleshooting

Solutions to common issues in TheDock.

General Issues​

TheDock won't load​

Symptoms: Blank screen, loading indefinitely, JavaScript errors

Solutions:

  1. Clear browser cache and refresh
  2. Try a different browser (Chrome/Firefox recommended)
  3. Disable browser extensions temporarily
  4. Check for JavaScript errors in browser console (F12)
  5. Increase PHP memory limit in wp-config.php: 
    define('WP_MEMORY_LIMIT', '256M');
  6. Deactivate other plugins to check for conflicts

Changes not saving​

Symptoms: Work disappears, reverts to previous state

Solutions:

  1. Check network connection
  2. Look for error messages in header
  3. Verify WordPress session hasn't expired
  4. Check server disk space
  5. Review PHP error logs
  6. Try manual save (Ctrl/Cmd + S)

Slow performance​

Symptoms: Laggy interface, slow preview updates

Solutions:

  1. Close unnecessary browser tabs
  2. Use a modern browser (Chrome/Firefox)
  3. Check server resources
  4. Reduce image file sizes
  5. Disable browser dev tools if open

Export Issues​

Export fails​

Symptoms: Export hangs, error message, incomplete export

Solutions:

  1. Increase PHP execution time
  2. Increase PHP memory limit
  3. Check folder permissions (wp-content/themes)
  4. Review PHP error logs
  5. Try exporting in smaller batches (CSS first, then templates)

Changes not visible after export​

Symptoms: Site looks the same after export

Solutions:

  1. Clear caching plugin cache
  2. Clear CDN cache if using one
  3. Hard refresh browser (Ctrl+Shift+R)
  4. Clear browser cache entirely
  5. Check correct theme is active
  6. Verify export completed successfully

CSS not applying​

Symptoms: Styles missing or wrong on live site

Solutions:

  1. Check CSS file is loading (browser dev tools > Network)
  2. Clear all caches
  3. Check for specificity conflicts
  4. Verify custom CSS syntax
  5. Re-export theme

Template Issues​

Template not showing​

Symptoms: Wrong template displays, default template used

Solutions:

  1. Verify template assignment in Theme Structure
  2. Check WordPress Reading settings
  3. Verify template is in "In Use" category
  4. Clear any caching
  5. Re-export and test

Sections overlapping​

Symptoms: Content overlaps incorrectly

Solutions:

  1. Check section padding settings
  2. Verify grid configuration
  3. Look for negative margins
  4. Check z-index values in custom CSS
  5. Preview on different devices

Content not displaying​

Symptoms: Blocks show empty, dynamic content missing

Solutions:

  1. Verify WordPress content exists
  2. Check block configuration
  3. Verify post type settings
  4. Check custom field mapping
  5. Review template structure

Design Issues​

Colors look different​

Symptoms: Colors vary between editor and site

Solutions:

  1. Check color values are correct
  2. Verify no conflicting CSS
  3. Check monitor color profile
  4. Clear caches and refresh

Fonts not loading​

Symptoms: Fallback fonts display, custom fonts missing

Solutions:

  1. Check font is properly selected
  2. Verify font files exist
  3. Check for CORS issues (browser console)
  4. Re-export theme
  5. Check font licensing

Spacing inconsistent​

Symptoms: Elements have unexpected spacing

Solutions:

  1. Check global spacing settings
  2. Verify default values
  3. Look for element-specific overrides
  4. Check responsive settings
  5. Inspect with browser dev tools

WordPress Integration Issues​

Symptoms: Navigation empty or missing

Solutions:

  1. Verify menu exists in Appearance > Menus
  2. Check menu location assignment
  3. Verify menu has items
  4. Check navigation block in template
  5. Re-export theme

Symptoms: Thumbnails missing, placeholders shown

Solutions:

  1. Verify images are set in WordPress
  2. Check image sizes are generated
  3. Verify template uses featured image
  4. Check file permissions
  5. Regenerate thumbnails (plugin)

Custom fields not displaying​

Symptoms: ACF data not appearing

Solutions:

  1. Verify ACF is installed and active
  2. Check field group location rules
  3. Verify field mapping in TheDock
  4. Ensure data is entered in WordPress
  5. Check field name accuracy

Mobile/Responsive Issues​

Layout breaks on mobile​

Symptoms: Overlapping content, broken layout on phones

Solutions:

  1. Check responsive preview in TheDock
  2. Review column span settings
  3. Check for fixed widths
  4. Test on actual devices
  5. Adjust mobile-specific settings

Text too small/large on mobile​

Symptoms: Typography issues on mobile devices

Solutions:

  1. Adjust mobile font sizes
  2. Check base size settings
  3. Review typographic scale
  4. Test with actual devices

WooCommerce Issues​

Product pages unstyled​

Symptoms: WooCommerce pages look broken

Solutions:

  1. Verify WooCommerce is active
  2. Check WooCommerce templates
  3. Re-export theme
  4. Review WooCommerce styling settings
  5. Check for plugin conflicts

Cart not updating​

Symptoms: AJAX cart not working

Solutions:

  1. Check for JavaScript errors
  2. Clear caches
  3. Disable conflicting plugins
  4. Verify AJAX is enabled
  5. Check PHP error logs

Getting More Help​

Before Contacting Support​

  1. Check this troubleshooting guide
  2. Search documentation
  3. Clear all caches
  4. Try in incognito/private mode
  5. Disable other plugins temporarily
  6. Note exact error messages
  7. Check browser console for errors

Information to Provide​

  • TheDock version
  • WordPress version
  • PHP version
  • Browser and version
  • Exact steps to reproduce issue
  • Error messages (screenshots)
  • Console errors

Support Channels​

← Back to Documentation