{"id":44905,"date":"2026-08-19T13:06:37","date_gmt":"2026-08-19T13:06:37","guid":{"rendered":"https:\/\/getshortcodes.com\/?post_type=docs&p=44905"},"modified":"2026-08-19T13:06:37","modified_gmt":"2026-08-19T13:06:37","slug":"conditional","status":"publish","type":"docs","link":"https:\/\/getshortcodes.com\/docs\/conditional\/","title":{"rendered":"Conditional"},"content":{"rendered":"\n

The [su_conditional]<\/code> shortcode displays its enclosed content only when a selected condition matches the current visitor or request. Use it for member-only messages, guest calls to action, role-specific instructions, scheduled announcements, device or language targeting, URL-based content, post context, cookies, and WooCommerce customer resources.<\/p>\n\n\n\n

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

Conditional is a wrapping shortcode. Select one condition, fill in the fields related to that condition, and place the content you want to control between the opening and closing shortcode tags. Text, HTML, and other shortcodes can be used inside it.<\/p>\n\n\n\n

The default is<\/code> operator displays the content when the condition matches. Set operator=\"is_not\"<\/code> to reverse the result.<\/p>\n\n\n\n

Basic usage<\/h3>\n\n\n\n
[su_conditional condition=\"logged_in\"]\n  Welcome back! Here is your private content.\n[\/su_conditional]<\/code><\/pre>\n\n\n\n
Available conditions<\/h2>\n\n\n\n
  • logged_in<\/code> \u2014 the visitor is logged in.<\/li>
  • logged_out<\/code> \u2014 the visitor is not logged in.<\/li>
  • user_role<\/code> \u2014 the current user has any of the specified WordPress roles.<\/li>
  • device<\/code> \u2014 WordPress identifies the request as mobile or desktop.<\/li>
  • language<\/code> \u2014 the current locale matches a full locale or two-letter language code.<\/li>
  • date<\/code> \u2014 the current date is inside an inclusive date range.<\/li>
  • time<\/code> \u2014 the current time is inside an inclusive daily time range.<\/li>
  • datetime<\/code> \u2014 the current date and time is inside an inclusive range.<\/li>
  • cookie<\/code> \u2014 a named cookie exists and, optionally, has an exact value.<\/li>
  • url<\/code> \u2014 the current request URL contains the specified text.<\/li>
  • referrer<\/code> \u2014 the HTTP referrer contains the specified text.<\/li>
  • post_type<\/code> \u2014 the current post has any of the specified post types.<\/li>
  • post_category<\/code> \u2014 the current post has any of the specified categories.<\/li>
  • woocommerce_purchase<\/code> \u2014 the logged-in WooCommerce customer bought any of the specified products.<\/li><\/ul>\n\n\n\n
    Parameters<\/h2>\n\n\n\n
    Parameter<\/th>Used with<\/th>Description<\/th>Values \/ format<\/th>Default<\/th><\/tr><\/thead>
    condition<\/code><\/td>All<\/td>Selects the rule that controls whether the enclosed content is displayed. Fields for other conditions are ignored.<\/td>logged_in<\/code>, logged_out<\/code>, user_role<\/code>, device<\/code>, language<\/code>, date<\/code>, time<\/code>, datetime<\/code>, cookie<\/code>, url<\/code>, referrer<\/code>, post_type<\/code>, post_category<\/code>, woocommerce_purchase<\/code><\/td>Empty<\/td><\/tr>
    operator<\/code><\/td>All<\/td>Controls whether the selected condition is used directly or inverted.<\/td>is<\/code>, is_not<\/code><\/td>is<\/code><\/td><\/tr>
    role<\/code><\/td>user_role<\/code><\/td>Matches when the logged-in user has any listed role.<\/td>One or more role slugs separated by commas, for example administrator,editor<\/code>.<\/td>Empty<\/td><\/tr>
    device<\/code><\/td>device<\/code><\/td>Selects the server-detected device type.<\/td>mobile<\/code>, desktop<\/code><\/td>mobile<\/code><\/td><\/tr>
    language<\/code><\/td>language<\/code><\/td>Matches the current WordPress locale.<\/td>A locale such as en_US<\/code> or a two-letter language code such as en<\/code>.<\/td>Empty<\/td><\/tr>
    cookie_name<\/code><\/td>cookie<\/code><\/td>Name of the cookie that must exist.<\/td>A valid cookie name.<\/td>Empty<\/td><\/tr>
    cookie_value<\/code><\/td>cookie<\/code><\/td>Optional exact cookie value. Leave empty to check only whether the cookie exists.<\/td>Plain text.<\/td>Empty<\/td><\/tr>
    product_id<\/code><\/td>woocommerce_purchase<\/code><\/td>Matches when the logged-in customer bought any listed product.<\/td>One or more numeric product IDs separated by commas.<\/td>Empty<\/td><\/tr>
    date_from<\/code>
    date_to<\/code><\/td>    		date<\/code><\/td>Inclusive start and end date. Either boundary can be omitted.<\/td>YYYY-MM-DD<\/code> in the WordPress site timezone.<\/td>Empty<\/td><\/tr>
    time_from<\/code>
    time_to<\/code><\/td>    		time<\/code><\/td>Inclusive daily start and end time. A range such as 22:00<\/code>\u201306:00<\/code> crosses midnight. Either boundary can be omitted.<\/td>HH:MM<\/code> in the WordPress site timezone.<\/td>Empty<\/td><\/tr>
    datetime_from<\/code>
    datetime_to<\/code><\/td>    		datetime<\/code><\/td>Inclusive start and end date and time. Either boundary can be omitted.<\/td>YYYY-MM-DD HH:MM<\/code> in the WordPress site timezone.<\/td>Empty<\/td><\/tr>
    url_contains<\/code><\/td>url<\/code><\/td>Text that must occur in the current request URL.<\/td>Plain text or a URL fragment.<\/td>Empty<\/td><\/tr>
    referrer_contains<\/code><\/td>referrer<\/code><\/td>Text that must occur in the optional HTTP referrer.<\/td>Plain text or a URL fragment.<\/td>Empty<\/td><\/tr>
    post_type<\/code><\/td>post_type<\/code><\/td>Matches when the current post has any listed post type.<\/td>One or more post type slugs separated by commas, for example post,page<\/code>.<\/td>Empty<\/td><\/tr>
    category<\/code><\/td>post_category<\/code><\/td>Matches when the current post has any listed category.<\/td>One or more category slugs or numeric IDs separated by commas.<\/td>Empty<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Examples<\/h2>\n\n\n\n
    Show content to logged-out visitors<\/h3>\n\n\n\n
    [su_conditional condition=\"logged_out\"]\n  Create a free account to access this resource.\n[\/su_conditional]<\/code><\/pre>\n\n\n\n
    Target selected user roles<\/h3>\n\n\n\n
    [su_conditional condition=\"user_role\" role=\"administrator,editor\"]\n  Editorial note: please review this page.\n[\/su_conditional]<\/code><\/pre>\n\n\n\n
    Schedule content by date and time<\/h3>\n\n\n\n
    [su_conditional condition=\"datetime\" datetime_from=\"2026-11-27 00:00\" datetime_to=\"2026-11-30 23:59\"]\n  The weekend offer is live.\n[\/su_conditional]<\/code><\/pre>\n\n\n\n
    Use a time range that crosses midnight<\/h3>\n\n\n\n
    [su_conditional condition=\"time\" time_from=\"22:00\" time_to=\"06:00\"]\n  Night support is now available.\n[\/su_conditional]<\/code><\/pre>\n\n\n\n
    Match a language<\/h3>\n\n\n\n
    [su_conditional condition=\"language\" language=\"en\"]\n  Read the English version of this guide.\n[\/su_conditional]<\/code><\/pre>\n\n\n\n