{"id":33821,"date":"2019-03-01T10:50:37","date_gmt":"2019-03-01T10:50:37","guid":{"rendered":"http:\/\/getshortcodes.com\/?post_type=docs&p=33821"},"modified":"2026-06-06T15:41:26","modified_gmt":"2026-06-06T15:41:26","slug":"posts","status":"publish","type":"docs","link":"https:\/\/getshortcodes.com\/docs\/posts\/","title":{"rendered":"Posts"},"content":{"rendered":"\n
\n

This shortcode now has an enhanced version with significantly more customization options and powerful features, giving you much greater flexibility to create exactly the look and functionality you need.<\/p>\n\n\n\n

Check out the Posts Grid \u2192<\/a><\/p>\n<\/div><\/div>\n\n\n

On this page<\/p>\n\n

  1. Description<\/a><\/li>
  2. Options<\/a><\/li>
  3. Pagination<\/a><\/li>
  4. Built-in templates<\/a>
    1. Default template<\/a><\/li>
    2. Teasers<\/a><\/li>
    3. Single post template<\/a><\/li>
    4. List<\/a><\/li><\/ol><\/li>
    5. Template editing<\/a><\/li>
    6. Creating custom templates<\/a><\/li>
    7. Adding custom template paths<\/a><\/li><\/ol><\/li><\/ol>\n\n\n

      Description<\/h2>\n\n\n\n

      The \n\n

      \n\n\t\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Quae dolorum natus nihil reiciendis<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Ipsum corrupti maxime quis.<\/p>\n

      Itaque voluptates vero illum.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Quae aut quis iste quisquam quasi molestiae<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Quia.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Cupiditate quia voluptatem sed rerum nemo<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Dicta pariatur sint praesentium.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Hic tempore quia iste voluptas<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Asperiores est qui ipsa voluptates vel quia ab. Sunt eum voluptates excepturi corrupti. Fugiat ut totam non rerum iste quis. Debitis autem velit sint vero. Quos eligendi nam at similique…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Perspiciatis dolore quidem repellendus<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Ea vel quasi et.<\/p>\n

      Perferendis voluptatem perspiciatis nobis nemo.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Sequi omnis porro harum similique<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Et laborum non quibusdam quibusdam Ullam voluptates Sit nobis nostrum suscipit vel Alias beatae harum qui omnis. Id quaerat autem voluptatem dolores. Consequatur eum nihil. Est voluptatem temporibus atque vel…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Ut rerum et officia incidunt est<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Id quo exercitationem consequuntur.<\/p>\n

      Cumque et saepe.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Vitae eos est laudantium molestiae ipsa<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Doloremque magnam quae.<\/p>\n

      Officiis dignissimos.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Consectetur repudiandae in eum sed<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Et quas ea aut modi amet repellendus unde. Qui quo ea cum nihil laborum quia Reprehenderit veritatis et praesentium repellat necessitatibus laborum dolorem. Sed nesciunt molestiae temporibus rerum. Nihil consequatur…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Dolorum aperiam eos voluptatem qui ex ad<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Perspiciatis dolore aut.<\/p>\n

      Earum neque deserunt hic.<\/p>\n

      Nihil explicabo iste est.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Eum error eligendi dolor ut illo<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Vitae officia laudantium cum sunt. In ullam laboriosam illum sint consectetur quis corrupti enim. In illo temporibus vel et sequi possimus consectetur. Aliquam ipsum commodi temporibus animi. Ut quia tempora…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Eligendi dolores neque consectetur sed nobis<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Quis ex magnam magni quas sit. Enim officia beatae fugiat optio. Assumenda voluptas et deleniti suscipit molestias. Molestiae et consequatur assumenda consequuntur id aliquid. Non quas et nulla nisi ut…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\n\t\n<\/div>\n<\/code> shortcode is intended for display of posts, pages, and various post types. You can display posts from a specific category or by a specific tag. You can also choose multiple taxonomies and select the number of displayed posts. This shortcode uses WP_Query<\/a> class.<\/p>\n\n\n\n

      Options<\/h2>\n\n\n\n
      Option name<\/th>Possible values<\/th>Default value<\/th><\/tr>
      template<\/strong>
      Relative path to the template file. Default templates placed in the plugin directory (templates folder). You can copy them under your theme directory and modify as you want. You can use following default templates that already available in the plugin directory:
      templates\/default-loop.php – posts loop
      templates\/teaser-loop.php – posts loop with thumbnail and title
      templates\/single-post.php – single post template
      templates\/list-loop.php – unordered list with posts titles<\/small><\/td>      		Any text value<\/td>templates\/default-loop.php<\/td><\/tr>
      id<\/strong>
      Enter comma separated ID’s of the posts that you want to show<\/small><\/td>      		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
      posts_per_page<\/strong>
      Specify number of posts that you want to show. Enter -1 to get all posts<\/small><\/td>      		Number from -1 to 10000<\/td>12<\/td><\/tr>
      post_type<\/strong>
      Select post types. Hold Ctrl key to select multiple post types<\/small><\/td>      		Post type slug(s) separated by comma(s)<\/td>post<\/td><\/tr>
      taxonomy<\/strong>
      Select taxonomy to show posts from<\/small><\/td>      		Taxonomy slug(s) separated by comma(s)<\/td>category<\/td><\/tr>
      tax_term<\/strong>
      Select terms to show posts from<\/small><\/td>      		Term slug(s) separated by comma(s)<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
      tax_operator<\/strong>
      Operator to test<\/small><\/td>      		IN (IN – posts that have any of selected categories terms)
      NOT IN (NOT IN – posts that is does not have any of selected terms)
      AND (AND – posts that have all selected terms)<\/td>      		IN<\/td><\/tr>
      author<\/strong>
      Enter here comma-separated list of author’s IDs. Example: 1,7,18<\/small><\/td>      		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
      meta_key<\/strong>
      Enter meta key name to show posts that have this key<\/small><\/td>      		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
      offset<\/strong>
      Specify offset to start posts loop not from first post<\/small><\/td>      		Number from 0 to 10000<\/td>0<\/td><\/tr>
      order<\/strong>
      Posts order<\/small><\/td>      		desc (Descending)
      asc (Ascending)<\/td>      		DESC<\/td><\/tr>
      orderby<\/strong>
      Order posts by<\/small><\/td>      		none (None)
      id (Post ID)
      author (Post author)
      title (Post title)
      name (Post slug)
      date (Date)
      modified (Last modified date)
      parent (Post parent)
      rand (Random)
      comment_count (Comments number)
      menu_order (Menu order)
      meta_value (Meta key values)
      meta_value_num (Meta key values (Numeric))<\/td>      		date<\/td><\/tr>
      post_parent<\/strong>
      Show childrens of entered post (enter post ID)<\/small><\/td>      		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
      post_status<\/strong>
      Show only posts with selected status<\/small><\/td>      		publish (Published)
      pending (Pending)
      draft (Draft)
      auto-draft (Auto-draft)
      future (Future post)
      private (Private post)
      inherit (Inherit)
      trash (Trashed)
      any (Any)<\/td>      		publish<\/td><\/tr>
      ignore_sticky_posts<\/strong>
      Set to \u201cyes\u201d to prevent sticky posts from being moved to the start of the returned list of posts. They are still included, but appear in regular order<\/small><\/td>      		yes or no<\/td>no<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Pagination<\/h2>\n\n\n\n

      Unfortunately, pagination is currently not available in the shortcode. This function will be added in future versions.<\/p>\n\n\n\n

      Built-in templates<\/h2>\n\n\n\n

      \n\n

      \n\n\t\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Quae dolorum natus nihil reiciendis<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Ipsum corrupti maxime quis.<\/p>\n

      Itaque voluptates vero illum.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Quae aut quis iste quisquam quasi molestiae<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Quia.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Cupiditate quia voluptatem sed rerum nemo<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Dicta pariatur sint praesentium.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Hic tempore quia iste voluptas<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Asperiores est qui ipsa voluptates vel quia ab. Sunt eum voluptates excepturi corrupti. Fugiat ut totam non rerum iste quis. Debitis autem velit sint vero. Quos eligendi nam at similique…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Perspiciatis dolore quidem repellendus<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Ea vel quasi et.<\/p>\n

      Perferendis voluptatem perspiciatis nobis nemo.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Sequi omnis porro harum similique<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Et laborum non quibusdam quibusdam Ullam voluptates Sit nobis nostrum suscipit vel Alias beatae harum qui omnis. Id quaerat autem voluptatem dolores. Consequatur eum nihil. Est voluptatem temporibus atque vel…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Ut rerum et officia incidunt est<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Id quo exercitationem consequuntur.<\/p>\n

      Cumque et saepe.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Vitae eos est laudantium molestiae ipsa<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Doloremque magnam quae.<\/p>\n

      Officiis dignissimos.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Consectetur repudiandae in eum sed<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Et quas ea aut modi amet repellendus unde. Qui quo ea cum nihil laborum quia Reprehenderit veritatis et praesentium repellat necessitatibus laborum dolorem. Sed nesciunt molestiae temporibus rerum. Nihil consequatur…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Dolorum aperiam eos voluptatem qui ex ad<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Perspiciatis dolore aut.<\/p>\n

      Earum neque deserunt hic.<\/p>\n

      Nihil explicabo iste est.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Eum error eligendi dolor ut illo<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Vitae officia laudantium cum sunt. In ullam laboriosam illum sint consectetur quis corrupti enim. In illo temporibus vel et sequi possimus consectetur. Aliquam ipsum commodi temporibus animi. Ut quia tempora…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t

      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t

      Eligendi dolores neque consectetur sed nobis<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t

      Quis ex magnam magni quas sit. Enim officia beatae fugiat optio. Assumenda voluptas et deleniti suscipit molestias. Molestiae et consequatur assumenda consequuntur id aliquid. Non quas et nulla nisi ut…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\n\t\n<\/div>\n<\/code> shortcode includes various templates which you can use to display your posts. Built-in templates are located in the following folder:<\/p>\n\n\n\n

      \/wp-content\/plugins\/shortcodes-ultimate\/includes\/partials\/shortcodes\/posts\/templates\/<\/code><\/pre>\n\n\n\n
      <\/p>\n\n\n\n
      Default template<\/h3>\n\n\n\n
      The default template that includes post featured image, post date, title, excerpt, and comments link.<\/p>\n\n\n\n
      [su_posts template=\"templates\/default-loop.php\"]<\/code><\/pre>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Teasers<\/h3>\n\n\n\n
      A simplified version of the default template which only includes post featured image and title.<\/p>\n\n\n\n
      [su_posts template=\"templates\/teaser-loop.php\"]<\/code><\/pre>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Single post template<\/h3>\n\n\n\n
      A template which only shows a single post at a time. Includes post title, post date, comments link, and the post content.<\/p>\n\n\n\n
      [su_posts template=\"templates\/single-post.php\"]<\/code><\/pre>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      List<\/h3>\n\n\n\n
      A template that shows queried posts as a plain HTML list.<\/p>\n\n\n\n
      [su_posts template=\"templates\/list-loop.php\"]<\/code><\/pre>\n\n\n\n
      \"\"<\/figure>\n\n\n\n
      Template editing<\/h2>\n\n\n\n
      Do not edit templates in the plugin folder, since all your changes will be lost after plugin update.<\/p>\n\n\n\n
      To modify a built-in template you should copy it to your theme directory first. For convenience, you can copy the whole templates<\/code> folder from the plugin folder.  You can rename the copied folder, it doesn’t have to be templates<\/code>. Resulting path to template files should look like so:<\/p>\n\n\n\n
      \/wp-content\/themes\/THEME-NAME\/templates\/<\/code><\/pre>\n\n\n\n
      Now you can edit copied template files.<\/p>\n\n\n\n
      Use the template<\/code> attribute to change the template used by shortcode. The value of this attribute must be a template file path relative to your theme’s folder. Example:<\/p>\n\n\n\n
      [su_posts template=\"templates\/default-loop.php\"]<\/code><\/pre>\n\n\n\n
      In the example above the plugin will search for a template in the following locations (in the specified order):<\/p>\n\n\n\n
      \/wp-content\/themes\/child-theme\/templates\/default-loop.php\n\/wp-content\/themes\/parent-theme\/templates\/default-loop.php\n\/wp-content\/plugins\/shortcodes-ultimate\/includes\/partials\/shortcodes\/posts\/templates\/default-loop.php<\/code><\/pre>\n\n\n\n
      Creating custom templates<\/h2>\n\n\n\n
      The \n\n
      \n\n\t\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Quae dolorum natus nihil reiciendis<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Ipsum corrupti maxime quis.<\/p>\n
      Itaque voluptates vero illum.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Quae aut quis iste quisquam quasi molestiae<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Quia.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Cupiditate quia voluptatem sed rerum nemo<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Dicta pariatur sint praesentium.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Hic tempore quia iste voluptas<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Asperiores est qui ipsa voluptates vel quia ab. Sunt eum voluptates excepturi corrupti. Fugiat ut totam non rerum iste quis. Debitis autem velit sint vero. Quos eligendi nam at similique…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Perspiciatis dolore quidem repellendus<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Ea vel quasi et.<\/p>\n
      Perferendis voluptatem perspiciatis nobis nemo.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Sequi omnis porro harum similique<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Et laborum non quibusdam quibusdam Ullam voluptates Sit nobis nostrum suscipit vel Alias beatae harum qui omnis. Id quaerat autem voluptatem dolores. Consequatur eum nihil. Est voluptatem temporibus atque vel…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Ut rerum et officia incidunt est<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Id quo exercitationem consequuntur.<\/p>\n
      Cumque et saepe.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Vitae eos est laudantium molestiae ipsa<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Doloremque magnam quae.<\/p>\n
      Officiis dignissimos.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Consectetur repudiandae in eum sed<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Et quas ea aut modi amet repellendus unde. Qui quo ea cum nihil laborum quia Reprehenderit veritatis et praesentium repellat necessitatibus laborum dolorem. Sed nesciunt molestiae temporibus rerum. Nihil consequatur…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Dolorum aperiam eos voluptatem qui ex ad<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Perspiciatis dolore aut.<\/p>\n
      Earum neque deserunt hic.<\/p>\n
      Nihil explicabo iste est.<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Eum error eligendi dolor ut illo<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Vitae officia laudantium cum sunt. In ullam laboriosam illum sint consectetur quis corrupti enim. In illo temporibus vel et sequi possimus consectetur. Aliquam ipsum commodi temporibus animi. Ut quia tempora…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\t\t\t\n\t\t\t\n\t\t\t
      \n\n\t\t\t\t\t\t\t\t\t\"\"<\/a>\n\t\t\t\t\n\t\t\t\t
      Eligendi dolores neque consectetur sed nobis<\/a><\/h2>\n\n\t\t\t\t
      \n\t\t\t\t\tPosted: June 6, 2026\t\t\t\t<\/div>\n\n\t\t\t\t
      \n\t\t\t\t\t
      Quis ex magnam magni quas sit. Enim officia beatae fugiat optio. Assumenda voluptas et deleniti suscipit molestias. Molestiae et consequatur assumenda consequuntur id aliquid. Non quas et nulla nisi ut…<\/p>\n\t\t\t\t<\/div>\n\n\t\t\t\t\t\t\t\t\t0 comments<\/a>\n\t\t\t\t\n\t\t\t<\/div>\n\n\t\t\n\t\n<\/div>\n<\/code> shortcode supports custom templates, which makes it incredibly powerful. Follow the steps below to create one.<\/p>\n\n\n\n
      Step 1<\/strong><\/p>\n\n\n\n
      Create a new folder in your theme directory and name it su-posts-templates<\/code>, so the resulting path would be:<\/p>\n\n\n\n
      \/wp-content\/themes\/YOUR-THEME-NAME\/su-posts-templates\/<\/code><\/pre>\n\n\n\n
      Step 2<\/strong><\/p>\n\n\n\n
      Create a new file in the su-posts-templates<\/code> folder and name it my-template.php<\/code>. The resulting path would be:<\/p>\n\n\n\n
      \/wp-content\/themes\/YOUR-THEME-NAME\/su-posts-templates\/my-template.php<\/code><\/pre>\n\n\n\n
      Step 3<\/strong><\/p>\n\n\n\n
      Put the following snippet into the created file:<\/p>\n\n\n\n
      <?php if ( $posts->have_posts() ) : ?>\n  <div class=\"su-posts su-posts-my-template\">\n    <?php while ( $posts->have_posts() ) : ?>\n      <?php $posts->the_post(); ?>\n      <a href=\"<?php the_permalink(); ?>\"><?php the_title(); ?><\/a>\n    <?php endwhile; ?>\n  <\/div>\n<?php else : ?>\n  <p>Posts not found!<\/p>\n<?php endif; ?><\/code><\/pre>\n\n\n\n
      Step 4<\/strong><\/p>\n\n\n\n
      Now you can use the created template:<\/p>\n\n\n\n
      [su_posts template=\"su-posts-templates\/my-template.php\"]<\/code><\/pre>\n\n\n\n
      Adding custom template paths<\/h2>\n\n\n\n
      If you need to store your templates outside of the theme directory, you can extend the list of allowed template paths. Use the following snippet in a custom plugin or in the functions.php<\/code> file:<\/p>\n\n\n\n
      add_filter(\n\t'su\/shortcode\/posts\/allowed_template_locations',\n\tfunction( $locations ) {\n\n\t\t\/\/ \/wp-content\/\n\t\t$locations[] = WP_CONTENT_DIR;\n\n\t\treturn $locations;\n\n\t},\n\t10,\n\t1\n);<\/code><\/pre>\n\n\n\n
      The code above will allow you to store templates under \/wp-content\/<\/code> directory.<\/p>\n","protected":false},"featured_media":36642,"template":"","docs_category":[21],"class_list":["post-33821","docs","type-docs","status-publish","has-post-thumbnail","hentry","docs_category-shortcodes"],"acf":[],"_links":{"self":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs\/33821","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=33821"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs_category?post=33821"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}