BugWP logo BugWP
Back to Community
Home / Community / Plugin → Gutenberg blocks with ai by kadence wp – page builder features

Troubleshooting Guide: Fixing Common Kadence Icon List Block Issues

24 threads Sep 16, 2025 Plugin → Gutenberg blocks with ai by kadence wp – page builder features

Content

The Kadence Icon List block is a powerful tool for creating visually engaging lists on your WordPress site. However, like any complex feature, it can sometimes run into issues. Based on community reports and solutions, here are the most common problems with the Icon List block and how to resolve them.

1. Icons Not Displaying or Block Appears Broken

This is a frequent issue that can have several causes.

  • Theme Conflict: A conflicting theme is a common culprit. To test this, temporarily switch to a default WordPress theme like Twenty Twenty-One. If the icons appear, the issue lies with your theme.
  • Plugin Conflict: A performance or optimization plugin might be preventing the necessary CSS or JavaScript from loading. Try temporarily disabling other plugins to identify a conflict.
  • User Role Permissions: Some users have reported that SVG icons fail to render correctly for user roles with lower permissions, like Authors. This appears to be a parsing error. Ensure you are using an up-to-date version of the plugin, as fixes are often released.
  • Check the Console: Use your browser's developer tools (F12) to check the Console tab for JavaScript errors. Errors pointing to blocks-iconlist.js can indicate a problem. Note that warnings about SCRIPT_DEBUG are often benign if you have that mode enabled in your wp-config.php file.

2. Problems Converting from a WordPress List Block

After WordPress 6.1 introduced a new nested structure for list items, a known bug prevented standard list blocks from converting correctly into Kadence Icon List blocks. The original list items would appear empty.

Solution: This specific bug was addressed in Kadence Blocks version 2.4.22. If you are experiencing this problem, the first step is to ensure your plugin is updated to the latest version.

3. Color Settings Not Working

In older versions of the plugin (e.g., around v1.7.4), a bug prevented color settings within the Icon List block from functioning correctly.

Solution: The development team has acknowledged and fixed such issues in subsequent updates. Always update to the newest version of Kadence Blocks to resolve known bugs.

4. Re-ordering Arrows Missing in Editor

Users reported that the up/down arrows for reordering list items disappeared from the editor interface in version 2.4.3.

Solution: The functionality was not removed but moved. The controls for moving and indenting list items are now located in the block toolbar for each individual list item, providing more layout options.

5. Mobile Responsiveness (Multi-Column Layout)

By default, an Icon List set to multiple columns may not automatically switch to a single column on mobile devices, potentially causing a cramped layout.

Solution: You can force a single-column layout on mobile using custom CSS. Add the following code to your theme's Customizer under "Additional CSS" or in a custom CSS plugin, adjusting the breakpoint (600px) as needed for your design.

@media screen and (max-width: 600px) {
    .kt-svg-icon-list-columns-2 ul.kt-svg-icon-list {
        grid-template-columns: repeat(1, minmax(0, 1fr)) !important;
    }
}

General Troubleshooting Steps

  • Update Everything: First, always ensure WordPress, your theme, and all plugins (especially Kadence Blocks) are updated to their latest versions. Many issues are patched in updates.
  • Clear Caches: Clear any site caching (from plugins or your host) and your browser cache after making changes or updates.
  • Conflict Test: The standard diagnostic process is to temporarily switch to a default theme and disable all other plugins. If the issue resolves, reactivate them one-by-one to find the conflict.

By following these steps, you can resolve the majority of issues encountered with the Kadence Icon List block. The Kadence Blocks team is generally responsive to bug reports and frequently releases updates to improve functionality and fix problems.

Related Support Threads Support