How to Use Conditional Display

This feature is only available in Stackable Premium

What is Conditional Display

Conditional Display allows you to assign conditions to every block, which when fulfilled will show or hide the block in the frontend.

You have the option to:

  • Assign whether to hide or show any block when the conditions are met
  • Use one or multiple conditions together for more complex needs
  • Choose whether ALL or ANY of your conditions should be met before showing a block

Current supported conditions:

  • Login Status
  • Role
  • Date & Time
  • Custom PHP
  • Conditional Tag
  • Query String
  • Post Meta
  • Site Option
  • Post IDs
  • Post Type
  • Post Taxonomy

How to Use Conditional Display

Select your chosen block, and navigate to the Advanced Tab in the inspector where you will see the Conditional Display tab.

Once you click on the Conditional Display tab, you will see the Visibility settings where you can choose between hiding or showing your block when the conditions are met.

If you want to add a condition, just click on the Add New Condition button, and a Condition Type section will appear. This is where you can select from our various supported conditions.

You can add as many conditions as you'd like and assign whether ALL of the conditions should be met, or ANY one of them.

Supported Conditions

Login Status

If you set this as the condition type, the block will be displayed or hidden depending on whether the users are logged in or logged out.

Role

If you set this as the condition type, the block will be displayed or hidden depending on the role assigned to them in the Role Manager (e.g. Administrator, Editor, Author, and more.)

Date & Time

If you set this as the condition type, the block will be displayed or hidden on the selected days.

Custom PHP

You can create your own logic here using PHP and when the condition is fulfilled then that can be used to display or hide the block.

For example, you can use this to display or hide the block if the current page has a specific post meta value:

get_post_meta( get_the_ID(), 'key', true ) !== false

If you want to display the block only if there is a Featured Image, you can add this Custom PHP:

has_post_thumbnail() !== false

If a category has any published posts, you can add this Custom PHP:

count(get_posts(['category_name' => 'Uncategorized', 'post_status' => 'publish', 'posts_per_page' => 1])) > 0

You can use Custom PHP code to match against a part of your current URL. For example:

str_contains( parse_url( $_SERVER['REQUEST_URI'] )['path'], '/author/1234' )

Conditional Tag

You can use WordPress conditional tags such as is_page() or is_singular() to decide whether the block will be displayed or hidden.

Query String

You can enter one query string per line here. The block will be displayed or hidden if any of the query strings found in the current URL match. For example, using variable=value will match if your URL is **http://mywebsite.com/?variable=value**

Post Meta

If you set this as the condition type, the block will be displayed or hidden based on the value of the current page’s post meta data. You can set the matching if the post meta data doesn’t exist, or matches a specific value or condition.

Site Option

If you set this as the condition type, the block will be displayed or hidden depending on the value of a site wide option (code-wise, this is a call to the get_option function)

Post IDs

If you set this as the condition type, the block will be displayed or hidden if the current post’s ID matches one of the Post ID/s you entered.

Post Type

If you set this as the condition type, the block will be displayed or hidden depending if the current post has the Post Type you entered.

Post Taxonomy

If you set this as the condition type, the block will be displayed or hidden depending if the current post has the Post Taxonomy you entered. You have the option to select the Post Type and Taxonomy Type (Categories or Tags).

If you'd like to perform Complex/Compound display decisions, a workaround could be to use the Columns block (or nest blocks), and then add conditions in the parents block as well as in the child block.