Skip to main content

Troubleshooting Common Issues

Updated

Running into issues? Here are solutions to common problems.

General Issues

Problem: Changes aren't showing on the front-end

Solutions:

  1. Hard refresh your browser:
    • Windows: Ctrl + F5
    • Mac: Cmd + Shift + R
  2. Clear site cache if using a caching plugin:
    • Look for "Clear Cache" or "Purge Cache" in your plugin
    • Common plugins: WP Rocket, W3 Total Cache, WP Super Cache
  3. Check if you saved:
    • Go back to the editor and click Save again
  4. Try a different browser to rule out browser issues

 

Problem: Site looks broken or unstyled

Solutions:

  1. Check if theme is activated:
    • Go to Appearance → Themes
    • Make sure Listimia shows "Active"
  2. Regenerate CSS:
    • Go to Appearance → Editor
    • Open Styles
    • Make a small change (change any color slightly)
    • Save
    • Change it back
    • Save again
  3. Check for plugin conflicts:
    • Deactivate all plugins except GeoDirectory
    • Check if site looks normal
    • Reactivate plugins one by one to find the culprit

 

Problem: Can't save changes / "Publishing failed" error

Solutions:

  1. Check your internet connection

  2. Increase PHP limits (ask your host or add to wp-config.php):

    define('WP_MEMORY_LIMIT', '256M');
  3. Disable security plugins temporarily (WordFence, Sucuri, etc.)
  4. Check file permissions - wp-content directory needs to be writable
  5. Contact your host - might be a server configuration issue

 

Pattern & Block Issues

Problem: Patterns not showing in the inserter

Solutions:

  1. Make sure you're in the right place:
    • Click + icon
    • Click Browse All
    • Select Patterns tab (not Blocks)
    • Choose Listimia from the dropdown
  2. Clear browser cache and refresh
  3. Update WordPress to the latest version
  4. Deactivate other themes (if you have multiple) - only Listimia should be active

 

Problem: Pattern content looks different after inserting

This is normal! Patterns adapt to your site's styles.

Solutions:

  1. Check your global styles - colors and fonts apply to patterns
  2. Customize the pattern after inserting - change colors, fonts, spacing
  3. Check if you're viewing in editor vs. front-end - slight differences are normal

 

Problem: Can't delete or edit a block

Solutions:

  1. Make sure you've selected the right block:
    • Click on it
    • Look at the block toolbar
    • Check the name in the toolbar
  2. Try selecting the parent block if nested
  3. Use the List View:
    • Click the list icon (☰) in the top toolbar
    • This shows all blocks in a hierarchy
    • Select and delete from there
  4. Switch to Code editor (three dots menu → Code editor) and delete the HTML
  5. Start over: Select all (Ctrl/Cmd + A) and delete, then re-add content

 

Header & Navigation Issues

Problem: Logo not displaying or too large/small

Solutions:

  1. Check image file:
  2. Re-upload the logo:
    • Follow Step 4 instructions again
    • Make sure you clicked Save twice
  3. Check if logo exists in both header versions:
    • Default Header
    • Header Transparent

 

Problem: Navigation menu not showing or broken

Solutions:

  1. Make sure you created a menu:
    • Go to Appearance → Editor → Patterns → Template Parts → Header → Main Navigation
    • Check if menu has items
    • If empty, add items
  2. Check Navigation block settings:
    • Select the Navigation block
    • In right sidebar, check Display settings
    • Make sure it's not set to hidden
  3. Clear cache and hard refresh browser

 

Problem: Submenu (dropdown) not working

Solutions:

  1. Check if properly created:
    • Parent item should have submenu items nested under it
    • Use List View (☰ icon) to check hierarchy
  2. Check AyeCode UI settings:
    • Go to Settings → AyeCode UI
    • Make sure "Load JS" is set to "Core + Popper"
  3. Clear cache
  4. Test on different browser

 

Style & Design Issues

Problem: Colors not changing when I edit global styles

Solutions:

  1. Check if custom CSS is overriding:
    • Go to Appearance → Editor → Additional CSS
    • Look for color definitions
    • Remove or modify if needed
  2. Check block-level styles:
    • Some blocks might have individual color settings
    • These override global styles
    • Edit at block level or remove block styles
  3. Try changing palette colors:
    • Sometimes individual colors don't work
    • Try changing the entire palette
  4. Clear all caches and hard refresh

 

Problem: Fonts not changing

Solutions:

  1. Make sure you're editing global typography:
    • Appearance → Editor → Styles → Typography
    • Changes here should apply everywhere
  2. Check if blocks have custom fonts:
    • Select individual blocks
    • Look for typography settings
    • Clear them to use global settings
  3. Check for custom CSS:
    • Might have font-family definitions overriding
  4. Some fonts might not be loaded:
    • Listimia uses system fonts and Google Fonts
    • If a specific font isn't working, try another

 

Problem: Why is my Header Dark Gray?

If your page header appears as a solid dark gray box instead of a beautiful photograph, don't worry, your site isn't broken!

The Reason: The "Cover Block" Fallback

Listimia v2.0 uses the WordPress Cover Block for its headers. This block is designed to be "Featured Image Aware."

  • If an image exists: It displays the image with a subtle dark overlay (to make your white text readable).

  • If NO image exists: The block displays its base Background Color, which is set to Dark Gray by default.

Solutions:

To replace the gray box with your own photo:

  1. Edit your Page or Listing.

  2. In the right-hand sidebar settings, find the Featured Image section.

  3. Upload your desired image (Recommended size: 1920px x 600px or larger).

  4. Click Update. The gray background will automatically be replaced by your photo.

 

Getting Additional Help

If none of these solutions work:

  1. Search the WordPress Support Forums:
  2. Check GeoDirectory docs
  3. Contact Our Support