{"id":44468,"date":"2026-06-05T18:35:37","date_gmt":"2026-06-05T18:35:37","guid":{"rendered":"https:\/\/getshortcodes.com\/?post_type=docs&#038;p=44468"},"modified":"2026-06-06T16:49:30","modified_gmt":"2026-06-06T16:49:30","slug":"posts-grid","status":"publish","type":"docs","link":"https:\/\/getshortcodes.com\/docs\/posts-grid\/","title":{"rendered":"Posts Grid"},"content":{"rendered":"\n<div class=\"wp-block-group has-black-color has-light-background-color has-text-color has-background has-link-color wp-elements-cce4acb8de72d5a1c6e05d3b3cc2b02a is-content-justification-space-between is-nowrap is-layout-flex wp-container-core-group-is-layout-b0ffac9c wp-block-group-is-layout-flex\">\n<p class=\"has-text-align-center wp-block-paragraph\" style=\"font-style:normal;font-weight:600\">This shortcode is available in Shortcodes Ultimate Pro<\/p>\n\n\n\n<div class=\"wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button is-style-primary\"><a class=\"wp-block-button__link wp-element-button\" href=\"\/pricing\/\"><strong>View Pricing \u2192<\/strong><\/a><\/div>\n<\/div>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Posts Grid is a <a href=\"\/pricing\/\">Shortcodes Ultimate Pro<\/a> shortcode for displaying WordPress posts in a responsive grid or list. It lets you filter posts by post type, taxonomy, terms, authors, keyword, and post IDs, and provides controls for the post card layout: featured image, title, meta fields, excerpt, read more link, and pagination.<\/p>\n\n\n\n<h2 id=\"features-overview\" class=\"wp-block-heading\">Features Overview<\/h2>\n\n\n\n<figure class=\"wp-block-embed aligncenter is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Posts Grid Shortcode Features\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/HWNUXCTHi9I?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<h2 id=\"parameters\" class=\"wp-block-heading\">Parameters<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Attribute<\/th><th>Generator tab<\/th><th>Description<\/th><th>Values \/ format<\/th><th>Default<\/th><\/tr><\/thead><tbody><tr><td><code>post_type<\/code><\/td><td>Query<\/td><td>Filters posts by post type.<\/td><td>Registered post type slug. Comma-separated values are accepted by the runtime.<\/td><td><code>post<\/code><\/td><\/tr><tr><td><code>taxonomy<\/code><\/td><td>Query<\/td><td>Limits results to posts associated with a taxonomy.<\/td><td>Registered taxonomy slug, or <code>any<\/code> to disable taxonomy filtering.<\/td><td><code>any<\/code><\/td><\/tr><tr><td><code>terms<\/code><\/td><td>Query<\/td><td>Selects taxonomy terms used by the taxonomy filter.<\/td><td>Term IDs or slugs, comma-separated. Used only when <code>taxonomy<\/code> is set.<\/td><td>Empty<\/td><\/tr><tr><td><code>operator<\/code><\/td><td>Query<\/td><td>Controls how selected taxonomy terms are matched.<\/td><td><code>IN<\/code>, <code>NOT IN<\/code>, <code>AND<\/code><\/td><td><code>IN<\/code><\/td><\/tr><tr><td><code>include<\/code><\/td><td>Query<\/td><td>Includes only selected posts.<\/td><td>Post IDs, comma-separated.<\/td><td>Empty<\/td><\/tr><tr><td><code>exclude<\/code><\/td><td>Query<\/td><td>Excludes selected posts.<\/td><td>Post IDs, comma-separated.<\/td><td>Empty<\/td><\/tr><tr><td><code>author<\/code><\/td><td>Query<\/td><td>Limits results to selected authors.<\/td><td>User IDs, comma-separated.<\/td><td>Empty<\/td><\/tr><tr><td><code>keyword<\/code><\/td><td>Query<\/td><td>Filters posts by a search keyword.<\/td><td>Plain text search string.<\/td><td>Empty<\/td><\/tr><tr><td><code>posts_per_page<\/code><\/td><td>Query<\/td><td>Sets the number of posts shown per page.<\/td><td>Integer from <code>-1<\/code> to <code>10000<\/code>; <code>-1<\/code> shows all posts. Invalid values fall back to <code>6<\/code>.<\/td><td><code>6<\/code><\/td><\/tr><tr><td><code>paged<\/code><\/td><td>Query, hidden<\/td><td>Sets the initial page number. Deep-link pagination can override it from the URL.<\/td><td>Integer from <code>1<\/code> to <code>10000<\/code>.<\/td><td><code>1<\/code><\/td><\/tr><tr><td><code>orderby<\/code><\/td><td>Query<\/td><td>Sorts retrieved posts by a WordPress query field.<\/td><td><code>none<\/code>, <code>id<\/code>, <code>author<\/code>, <code>title<\/code>, <code>name<\/code>, <code>date<\/code>, <code>modified<\/code>, <code>parent<\/code>, <code>rand<\/code>, <code>comment_count<\/code>, <code>menu_order<\/code>, <code>meta_value<\/code>, <code>meta_value_num<\/code>, <code>post__in<\/code><\/td><td><code>date<\/code><\/td><\/tr><tr><td><code>order<\/code><\/td><td>Query<\/td><td>Sets ascending or descending sort order.<\/td><td><code>DESC<\/code>, <code>ASC<\/code><\/td><td><code>DESC<\/code><\/td><\/tr><tr><td><code>ignore_sticky<\/code><\/td><td>Query<\/td><td>Ignores sticky posts when set to <code>yes<\/code>.<\/td><td>Boolean<\/td><td><code>yes<\/code><\/td><\/tr><tr><td><code>layout<\/code><\/td><td>Layout<\/td><td>Selects the Posts Grid layout.<\/td><td><code>grid<\/code>, <code>list<\/code><\/td><td><code>grid<\/code><\/td><\/tr><tr><td><code>grid_columns<\/code><\/td><td>Layout<\/td><td>Sets the number of columns on desktop screens.<\/td><td>Integer from <code>1<\/code> to <code>12<\/code>. Invalid values fall back to <code>3<\/code>.<\/td><td><code>3<\/code><\/td><\/tr><tr><td><code>grid_tablet_columns<\/code><\/td><td>Layout<\/td><td>Sets the number of columns on tablet screens.<\/td><td>Integer from <code>1<\/code> to <code>12<\/code>. Invalid values fall back to <code>2<\/code>.<\/td><td><code>2<\/code><\/td><\/tr><tr><td><code>grid_mobile_columns<\/code><\/td><td>Layout<\/td><td>Sets the number of columns on mobile screens.<\/td><td>Integer from <code>1<\/code> to <code>12<\/code>. Invalid values fall back to <code>1<\/code>.<\/td><td><code>1<\/code><\/td><\/tr><tr><td><code>list_thumbnail_max_width<\/code><\/td><td>Layout<\/td><td>Sets the maximum featured image width for list layout.<\/td><td>Pixels, integer from <code>20<\/code> to <code>1200<\/code>. Invalid values fall back to <code>300<\/code>.<\/td><td><code>300<\/code><\/td><\/tr><tr><td><code>horizontal_gap<\/code><\/td><td>Layout<\/td><td>Sets horizontal gap in pixels. In list layout, this controls the gap between the thumbnail and title.<\/td><td>Pixels, integer <code>0<\/code> or greater.<\/td><td><code>24<\/code><\/td><\/tr><tr><td><code>vertical_gap<\/code><\/td><td>Layout<\/td><td>Sets vertical gap in pixels. In list layout, this controls the gap between list items.<\/td><td>Pixels, integer <code>0<\/code> or greater.<\/td><td><code>24<\/code><\/td><\/tr><tr><td><code>skin<\/code><\/td><td>Layout, hidden<\/td><td>Selects the Posts Grid skin.<\/td><td>CSS class-safe skin slug. Currently registered value: <code>default<\/code>.<\/td><td><code>default<\/code><\/td><\/tr><tr><td><code>accent_color<\/code><\/td><td>Single Post<\/td><td>Sets accent color for post title links, meta links, and pagination.<\/td><td>CSS color value accepted by <code>su_sanitize_css_color()<\/code>.<\/td><td><code>#0088ff<\/code><\/td><\/tr><tr><td><code>show_image<\/code><\/td><td>Single Post<\/td><td>Shows the featured image.<\/td><td>Boolean<\/td><td><code>yes<\/code><\/td><\/tr><tr><td><code>image_size<\/code><\/td><td>Single Post<\/td><td>Selects featured image size.<\/td><td><code>full<\/code> or any registered WordPress intermediate image size.<\/td><td><code>medium_large<\/code><\/td><\/tr><tr><td><code>image_ratio<\/code><\/td><td>Single Post<\/td><td>Sets featured image aspect ratio.<\/td><td><code>21:9<\/code>, <code>16:9<\/code>, <code>16:10<\/code>, <code>5:4<\/code>, <code>4:3<\/code>, <code>3:2<\/code>, <code>2:1<\/code>, <code>1:1<\/code>, <code>1:2<\/code>, <code>2:3<\/code>, <code>3:4<\/code>, <code>4:5<\/code>, <code>10:16<\/code>, <code>9:16<\/code>, <code>9:21<\/code>, or a numeric ratio.<\/td><td><code>16:9<\/code><\/td><\/tr><tr><td><code>image_border_radius<\/code><\/td><td>Single Post<\/td><td>Sets featured image border radius.<\/td><td>Pixels, integer <code>0<\/code> or greater.<\/td><td><code>5<\/code><\/td><\/tr><tr><td><code>show_title<\/code><\/td><td>Single Post<\/td><td>Shows the post title.<\/td><td>Boolean<\/td><td><code>yes<\/code><\/td><\/tr><tr><td><code>title_tag<\/code><\/td><td>Single Post<\/td><td>Sets the HTML tag used for post titles.<\/td><td><code>h2<\/code>, <code>h3<\/code>, <code>h4<\/code>, <code>h5<\/code>, <code>h6<\/code><\/td><td><code>h3<\/code><\/td><\/tr><tr><td><code>title_text_size<\/code><\/td><td>Single Post<\/td><td>Sets post title text size. <code>0<\/code> uses the default size.<\/td><td>Pixels, integer from <code>0<\/code> to <code>120<\/code>. Invalid values fall back to <code>0<\/code>.<\/td><td><code>0<\/code><\/td><\/tr><tr><td><code>show_meta<\/code><\/td><td>Single Post<\/td><td>Shows post meta.<\/td><td>Boolean<\/td><td><code>yes<\/code><\/td><\/tr><tr><td><code>meta_fields<\/code><\/td><td>Single Post<\/td><td>Selects meta fields and their order.<\/td><td>Comma-separated list. Generator values: <code>date<\/code>, <code>category<\/code>, <code>author<\/code>, <code>comments<\/code>. Runtime also renders <code>modified<\/code>.<\/td><td><code>date, category<\/code><\/td><\/tr><tr><td><code>show_excerpt<\/code><\/td><td>Single Post<\/td><td>Shows the post excerpt.<\/td><td>Boolean<\/td><td><code>yes<\/code><\/td><\/tr><tr><td><code>excerpt_length<\/code><\/td><td>Single Post<\/td><td>Sets the maximum number of words in the excerpt.<\/td><td>Integer <code>0<\/code> or greater.<\/td><td><code>18<\/code><\/td><\/tr><tr><td><code>show_read_more<\/code><\/td><td>Single Post<\/td><td>Shows the read more link.<\/td><td>Boolean<\/td><td><code>no<\/code><\/td><\/tr><tr><td><code>read_more_text<\/code><\/td><td>Single Post<\/td><td>Sets read more link text.<\/td><td>Plain text.<\/td><td><code>Read more...<\/code><\/td><\/tr><tr><td><code>pagination<\/code><\/td><td>Advanced<\/td><td>Controls pagination mode.<\/td><td><code>none<\/code>, <code>ajax-numbers<\/code>, <code>ajax-prev-next<\/code>, <code>deep-links-numbers<\/code>, <code>deep-links-prev-next<\/code><\/td><td><code>ajax-numbers<\/code><\/td><\/tr><tr><td><code>open_links_in_new_tab<\/code><\/td><td>Advanced<\/td><td>Opens post links in a new browser tab.<\/td><td>Boolean<\/td><td><code>no<\/code><\/td><\/tr><tr><td><code>empty_text<\/code><\/td><td>Advanced<\/td><td>Sets text shown when no posts are found.<\/td><td>Plain text.<\/td><td><code>No posts<\/code><\/td><\/tr><tr><td><code>class<\/code><\/td><td>Advanced<\/td><td>Adds extra CSS class names to the wrapper.<\/td><td>Space-separated CSS class names.<\/td><td>Empty<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"featured_media":36642,"template":"","docs_category":[21],"class_list":["post-44468","docs","type-docs","status-publish","has-post-thumbnail","hentry","docs_category-shortcodes"],"acf":[],"_links":{"self":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs\/44468","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/types\/docs"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/media\/36642"}],"wp:attachment":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/media?parent=44468"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs_category?post=44468"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}