--- title: "Posts" date: 2018-09-04 author: "nK" --- # Posts Shows posts. Pick a post type or one of the query modes, then narrow the query. ![](https://staging.visualportfolio.com/wp-content/uploads/2018/09/Shot-2026-03-25-at-13.03.20-1024x610.jpg)![](https://staging.visualportfolio.com/wp-content/uploads/2018/09/Shot-2026-03-25-at-13.03.20-1024x610.jpg) ## Source OptionWhat it showsSettings availableA post type (Post, Page, Portfolio, any public type)Posts of that typeAll of the below**Post Types Set**Several post types togetherPost Types, then all of the below**Manual Selection**Exactly the posts you pickSpecific Posts, Order by, Order Direction. Excluded Posts, Taxonomies and Offset are disabled; sticky posts are ignored**Custom Query**Whatever a WordPress query string returnsCustom Query, Avoid Duplicates. Order and Offset come from the query string**Current Query**What the page itself is showing: the projects of the Portfolio page, the posts of a category archive, search resultsAvoid Duplicates only; Items Per Page is hiddenMore than six post types collapse behind a **More** button. ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-18.44.01-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-18.44.01-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.06.28-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.06.28-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.07.49-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.07.49-1024x581.png) ## Settings SettingValuesDefaultNotes**Post Types** (Post Types Set)Any public post typesPost**Specific Posts** (Manual Selection)Search by title, up to 50 results at a time, any post typenoneChoose Order by **Manual Selection** to keep the picked order**Excluded Posts**Search by titlenone**Taxonomies**Terms of the taxonomies attached to the post type; grouped by taxonomynone**Taxonomies Relation**OR, ANDOROR: posts in any of the terms. AND: posts in all of them. Example: “2018” OR “2019” shows both years; “design” AND “2018” shows design work from 2018**Order by**Date, Title, ID, Comments Count, Modified, Menu Order, Manual Selection, RandomDateMenu Order sorts by the order plugins such as Post Types Order set, newest first within equal values. Random draws a new order per visitor session and keeps it across Load More and pages**Order Direction**ASC, DESCDESC**Avoid Duplicates**on / offoffHides posts that another Visual Portfolio block on the same page already showed. Works on the live site, not in the editor preview**Offset**0 to 1000Skips the first N posts. With pagination the plugin adds the offset to every page and corrects the page count**Authors** (Pro)Users, searched by namenoneOnly posts by these authors**Date** (Pro)All, Past Day, Past Week, Past Month, Past Quarter, Past Year, CustomAllCustom shows **After Date** and **Before Date** (inclusive)**Ignore Sticky Posts** (Pro)on / offoffSticky posts are otherwise placed first by WordPress**Exclude Posts Without Thumbnail** (Pro)on / offoffOnly posts with a featured imageAuthors, Date, Ignore Sticky Posts and Exclude Posts Without Thumbnail are hidden for Custom Query and Current Query; Ignore Sticky Posts is also hidden for Manual Selection. ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-18.45.44-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-18.45.44-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-18.48.31-1024x580.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-18.48.31-1024x580.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-19.58.33-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-19.58.33-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-19.59.41-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-19.59.41-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.00.34-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.00.34-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.01.53-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.01.53-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.03.10-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.03.10-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.03.57-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.03.57-1024x581.png) ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.04.45-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.04.45-1024x581.png) ## Custom Query A query string in the form WordPress `WP_Query` accepts, merged over the block’s defaults. Examples: ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.09.23-1024x573.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-20.09.23-1024x573.png) Posts from the “branding” category published in 2012, oldest first: ``` post_type=post&category_name=branding&year=2012&order=ASC ``` The same for projects (Portfolio Categories need a `tax_query`): ``` post_type=portfolio&tax_query[0][taxonomy]=portfolio_category&tax_query[0][field]=slug&tax_query[0][terms]=branding&year=2012&order=ASC ``` Images from the Media Library as posts: ``` post_type=attachment&post_status=inherit&post_mime_type=image ``` See [WP\_Query](https://developer.wordpress.org/reference/classes/wp_query/) for the parameters. ## Current Query Use it on the Portfolio page and on archive templates. It also works with filtering plugins such as FacetWP that change the main query. ![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-13.35.04-1024x581.png)![](https://staging.visualportfolio.com/wp-content/uploads/2024/07/Shot-2024-07-11-at-13.35.04-1024x581.png) ## Which posts get a lightbox With the Popup click action a post opens in the lightbox when it has a featured image, or the Video format with a Video URL; with Pro also the Audio and Gallery formats and custom media. Posts without any of these link to the post instead.