When they search, make sure they find you!

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 taxonomy attribute is set to the correct taxonomy slug.
  • Check that the posts_per_page value 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:

  1. Open the browser console (F12 > Console) and look for JavaScript errors. Common causes include jQuery conflicts or a minification plugin that broke the script.
  2. Check the Network tab for failed requests to admin-ajax.php. A security plugin or WAF may be blocking AJAX POST requests.
  3. 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.css or id-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-item elements.
  • If you’ve set a custom button_color, verify it’s a valid hex value (e.g., #e91e63).

Featured Post Not Showing

  • Confirm the featured attribute is set to recent or specific (not none).
  • If using featured="specific", verify the featured_post_id is 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_image is set to yes.
  • Verify that posts have featured images set. Posts without a featured image display a gray placeholder.
  • If images appear broken, the selected image_size may not exist. Try switching to medium_large, large, or full.