Common Issues
Below are the most frequently encountered issues with ID Post Grid, along with step-by-step solutions.
Grid Shows No Posts
If the grid renders but displays no posts or the “No posts found” message:
- Verify that published posts exist for the selected post type.
- If you’ve set
include_categories, confirm the term IDs are correct and belong to the right taxonomy. - If using a custom post type, make sure the
taxonomyattribute is set to the correct taxonomy slug. - Check that the
posts_per_pagevalue is greater than 0.
Search, Filter, or Load More Not Working
These features rely on AJAX (JavaScript). If they don’t respond to clicks or input:
- Open the browser console (
F12> Console) and look for JavaScript errors. Common causes include jQuery conflicts or a minification plugin that broke the script. - Check the Network tab for failed requests to
admin-ajax.php. A security plugin or WAF may be blocking AJAX POST requests. - Confirm that jQuery is loaded on the page. Some performance plugins defer or remove jQuery, which breaks the grid’s JavaScript.
Post Grid Element Not Appearing in WPBakery
The “ID Post Grid” element requires WPBakery Page Builder to be installed and active. It appears under the Content category in the element picker. If it’s missing, deactivate and reactivate ID Post Grid to re-trigger registration.
Post Grid Block Not Appearing in IDVE
The “Post Grid” block appears in IDVE’s Shortcodes category. Both ID Post Grid and IDVE must be active. If the block doesn’t appear, deactivate and reactivate ID Post Grid.
Styling Looks Wrong or Broken
- Check that the plugin’s CSS file (
id-post-grid.cssorid-post-grid.min.css) is loading. Look in the Network tab of developer tools. - A theme or another plugin may be overriding styles. Use the browser inspector to check for conflicting CSS rules on
.id-post-grid-itemelements. - If you’ve set a custom
button_color, verify it’s a valid hex value (e.g.,#e91e63).
Featured Post Not Showing
- Confirm the
featuredattribute is set torecentorspecific(notnone). - If using
featured="specific", verify thefeatured_post_idis a valid, published post ID. - The featured post is hidden when a search or filter is active. Clear the search and reset the filter to see it again.
Wrong Number of Columns on Mobile
The grid automatically adjusts to 2 columns on tablets (below 991px) and 1 column on mobile (below 575px). This is built-in and cannot be changed through shortcode attributes. To override, add custom CSS in your theme targeting the .id-post-grid selector with the --id-pg-columns custom property inside the appropriate media query.
Images Not Displaying
- Make sure
show_imageis set toyes. - Verify that posts have featured images set. Posts without a featured image display a gray placeholder.
- If images appear broken, the selected
image_sizemay not exist. Try switching tomedium_large,large, orfull.
