Troubleshooting

conclusion

Most ZenBlocks issues are resolved by Clearing the CSS cache, Re-enabling the plugin, and Clearing the browser cache. We will guide you through specific steps for each problem below.

Blocks are not displayed in the insert panel

Confirmation procedure

  1. Check if the plugin is activated
  • WordPress management screen > Open Plugin
  • Check if ZenBlocks is in the list and displayed as "enabled"
  • If "Disabled", click Enable
  1. Check the version of WordPress
  • Check WordPress version in Dashboard > Updates
  • ZenBlocks requires WordPress 6.0 or higher
  1. Check if Classic Editor is enabled
  • Block editor may be disabled if Classic Editor plugin is enabled
  • Make sure the default editor is set to "Block Editor" in Settings > Post Settings
  1. Check for conflicts with other plugins
  • Temporarily disable all other plugins and enable only ZenBlocks and check.
  • If it appears, enable other plugins one by one to identify the cause of the conflict.

Settings panel does not open/display

Confirmation procedure

  1. Make sure block is selected
  • Click on a block to select it
  • Check if a selection frame (blue frame) is displayed around the block.
  1. Check if the sidebar is visible
  • Click the Settings icon (gear symbol) in the top right corner of the editor to display the sidebar.
  • Make sure the Block tab at the top of the sidebar is selected
  1. Check for errors in your browser's developer tools
  • Open your browser's developer tools (F12)
  • Check if there is a JavaScript error on the Console tab
  • If there is an error, please report it to the support forum with a screenshot.

Styles not applied on front end

Confirmation procedure

  1. Clear CSS cache
  • WordPress management screen > Settings > Open ZenBlocks
  • Clear CSS Cache Click the button
  • Re-save the target page (press the update button)
  1. Clear browser cache
  • clear browser cache
  • or force reload (Ctrl+Shift+R / Cmd+Shift+R)
  1. Resave page
  • Open the target page in the editor
  • Refresh button to resave the page
  • CSS file is regenerated
  1. Check server side cache
  • If you are using a caching plugin (WP Super Cache, W3 Total Cache, LiteSpeed Cache, etc.), clear that cache as well.
  • If you are using a CDN (such as Cloudflare), also purge the CDN cache.

Point: CSS cache of ZenBlocks is stored in /wp-content/uploads/zenblocks/. Make sure this directory is writable.

Responsive settings are not reflected

Confirmation procedure

  1. Check if device-specific values are set
  • Check by clicking the device icon (PC / MD / TB / SP) in each settings panel in the sidebar.
  • If the value is empty for a particular device, the value of PC is used as a fallback.
  1. Check breakpoint settings
  • Check the breakpoint value in Settings > ZenBlocks
  • Check if the customized values are as intended
  1. Clear CSS cache
  • Responsive CSS is cached, so you need to clear the cache after changing settings.
  • Click Settings > ZenBlocks > Clear CSS Cache
  1. Check in responsive mode of browser
  • Open your browser's developer tools (F12)
  • Change the width to match the breakpoint in the device toolbar (responsive mode)
  • Check the display at each breakpoint

Animation doesn't work

Confirmation procedure

  1. Check if Pro function is enabled (Animation is Pro function)
  • Check if the license is "Active" in Settings > ZenBlocks
  • Check if ZenBlocks Pro plugin is enabled
  1. Check animation settings
  • Open the Animation Settings panel in the sidebar
  • Check if the animation type is set to something other than "None"
  • Check if Duration (playback time) is not set to 0.
  1. Check on the front end
  • Animations can be previewed within the editor, but final confirmation is done on the front end.
  • Reload the page to see the animation play
  1. Check for conflicts with transition settings
  • If animation and transition settings are enabled at the same time, unintended behavior may occur.
  • Check if there is a warning displayed on the transition settings panel.

Hover effect doesn't work

Confirmation procedure

  1. Check if there is a value in the Hover tab
  • Select the Hover tab in the sidebar settings panel
  • Check that the property you want to change (background color, text color, etc.) has a value.
  1. Check transition settings
  • Check if Duration in the transition settings panel is not 0ms
  • Recommended value: 200~400ms
  1. Clear CSS cache and check again

For more information, see buttonBasic FAQ: Styles are not reflected on hover.

Block validation error is displayed

Confirmation procedure

  1. Update the plugin to the latest version
  • Update ZenBlocks to the latest version from WordPress management screen > Plugins> Update
  1. Recover Block
  • Click Attempt to recover block in the error message
  • After recovery, check if the settings are as intended and resave the page.
  1. If that doesn't work
  • Delete the block and create a new one
  • If saved as a custom design, apply the preset to the new block and restore

Note: Validation errors may occur if the output format of HTML is changed in a plugin update. Block recovery will automatically update to the new format.

If the problem persists

If the above steps do not resolve the issue, please post on the WordPress.org Support Forum.

When submitting, please include the following information:

  • WordPress version
  • PHP version
  • Theme name in use
  • ZenBlocks / ZenBlocks Pro version
  • Steps to reproduce the problem
  • Screenshot or screen recording
  • Error messages displayed in the browser's developer tools Console