The [id_post_grid] shortcode renders a post grid anywhere WordPress processes shortcodes — posts, pages, widgets, and custom templates (via do_shortcode()).
Full Example
[id_post_grid post_type="post" posts_per_page="12" template="overlay" columns="3" grid_gap="20" show_search="yes" show_filter="yes" show_load_more="yes" featured="recent" button_color="#e91e63" button_style="pill"]
General Attributes
| Attribute |
Type |
Default |
Description |
post_type |
String |
post |
Any public post type. |
posts_per_page |
Integer |
9 |
Posts to load initially and per load more click. |
excerpt_length |
Integer |
20 |
Word count for excerpts. |
orderby |
String |
date |
Sort field: date, title, modified, rand, menu_order. |
order |
String |
DESC |
Sort direction: DESC or ASC. |
include_categories |
String |
(empty) |
Comma-separated term IDs to limit results. |
taxonomy |
String |
(auto) |
Taxonomy slug. Auto-detected if empty. |
Layout Attributes
| Attribute |
Type |
Default |
Description |
template |
String |
card |
Template: card, overlay, minimal, horizontal. |
columns |
Integer |
3 |
Grid columns: 1–4. |
grid_gap |
Integer |
30 |
Gap between items in pixels. |
controls_align |
String |
center |
Controls alignment: left, center, right. |
featured |
String |
none |
Featured post: none, recent, specific. |
featured_post_id |
Integer |
(empty) |
Post ID when featured="specific". |
featured_image_size |
String |
large |
Image size for the featured post. |
Feature Attributes
| Attribute |
Type |
Default |
Description |
show_search |
String |
yes |
Show search input: yes or no. |
search_placeholder |
String |
Search posts... |
Placeholder text for the search input. |
show_filter |
String |
yes |
Show category filter buttons: yes or no. |
all_filter_text |
String |
All |
Label for the “show all” filter button. |
show_load_more |
String |
yes |
Show load more button: yes or no. |
load_more_text |
String |
Load More |
Button label. |
loading_text |
String |
Loading... |
Text shown while loading. |
no_results_text |
String |
No posts found. |
Message when no posts match. |
Display Attributes
| Attribute |
Type |
Default |
Description |
show_image |
String |
yes |
Show featured image. |
image_size |
String |
medium_large |
WordPress image size for grid items. |
show_title |
String |
yes |
Show post title. |
show_excerpt |
String |
yes |
Show excerpt text. |
show_date |
String |
yes |
Show publish date. |
show_category |
String |
yes |
Show category label. |
show_read_more |
String |
yes |
Show read more link/button. |
read_more_text |
String |
Read More |
Read more link text. |
read_more_style |
String |
text |
Style: text (link) or button. |
Style Attributes
| Attribute |
Type |
Default |
Description |
button_color |
String |
(empty) |
Hex color for active filter, load more, and read more buttons. |
button_style |
String |
square |
Border radius: square (0px), rounded (4px), pill (999px). |
el_class |
String |
(empty) |
Extra CSS class on the wrapper element. |
Using in Templates
<?php echo do_shortcode( '[id_post_grid posts_per_page="6" template="minimal" columns="2"]' ); ?>
