Use this page to find the available rules, their inline syntax, and the settings offered by Condition Sets. You can enter inline attributes yourself or use the editor button to generate its supported rules.
Free and Pro Rules
Free and Pro both support Menu Items, Home Page, Date, Access Levels, User Groups, Languages, and Devices. The other rule types require Pro.
Both editions can reference reusable Condition Sets. The same edition limits apply inside those sets, including nested sets: a Pro-only rule does not become available by putting it in a Condition Set. Use only supported rules in sets used by Free; unsupported rules are ignored.
Inline Rule Reference
Inline rules are attributes in a {show} or {hide} tag. For example:
{show device="mobile"}Content for mobile visitors.{/show}
The reference uses the parser's canonical attribute names. The editor button may generate equivalent aliases, such as devices, menuitems, or usergroups.
Editor button means the rule has a selector in the inline editor popup. Manual means the tag parser accepts the rule, but the popup has no dedicated inline selector. These rules are also available through Condition Sets.
| Attribute | Values and example | Entry | Edition |
|---|---|---|---|
menu_item | Menu item IDsmenu_item="101,102" | Editor button | Free & Pro |
home_page | true or falsehome_page="true" | Editor button | Free & Pro |
date | Date/time range, or > / < followed by a datedate="2026-01-01 to 2026-12-31" | Editor button | Free & Pro |
access_level | Access level IDs or namesaccess_level="Registered" | Editor button | Free & Pro |
user_group | User group IDs or namesuser_group="Registered" | Editor button | Free & Pro |
language | Language tagslanguage="en-GB,nl-NL" | Editor button | Free & Pro |
device | desktop, tablet, mobiledevice="mobile" | Editor button | Free & Pro |
season | winter, spring, summer, autumnseason="summer" | Editor button | PRO |
month | Month numbers or namesmonth="6,7,8" | Editor button | PRO |
day | Weekday names or 1 (Monday) to 7 (Sunday)day="1,2,3,4,5" | Editor button | PRO |
time | Time range, or > / < followed by a timetime="09:00 to 17:00" | Editor button | PRO |
page_type | Joomla content view names; use the popup to select thempage_type="article" | Editor button | PRO |
category | Joomla category IDscategory="12,15" | Editor button | PRO |
article | Article IDsarticle="123,456" | Editor button | PRO |
featured | true or falsefeatured="true" | Editor button | PRO |
article_status | published, unpublished, archived, trashed, or their numeric statesarticle_status="published" | Editor button | PRO |
article_date | Article date range or > / < comparison; defaults to created datearticle_date=">2026-01-01" | Editor button | PRO |
created / modified / publish_up / publish_down | Date-specific alternatives to article_datemodified=">2026-01-01" | Manual | PRO |
article_author | Article author selection; use IDs for unambiguous matchingarticle_author="123" | Editor button | PRO |
content_keyword | Text to find in article contentcontent_keyword="Joomla" | Manual | PRO |
meta_keyword | Text to find in article meta keywordsmeta_keyword="Joomla" | Manual | PRO |
Custom field name | The field name is the attribute; the value is a comparisonevent_price=">=25" | Manual | PRO |
user | Current user ID, username, or email addressuser="123,456" | Editor button | PRO |
ip | Visitor IP addresses or rangesip="192.0.2.10" | Editor button | PRO |
os | Operating system identifier from the Conditions selectoros="Windows" | Manual | PRO |
browser | Browser identifier from the Conditions selectorbrowser="Chrome" | Manual | PRO |
browser_mobile | Mobile browser identifier from the Conditions selectorbrowser_mobile="Chrome" | Manual | PRO |
continent | Continent codes; requires the GeoIP librarycontinent="EU" | Editor button | PRO |
country | Country codes; requires the GeoIP librarycountry="NL,BE" | Editor button | PRO |
region | Country-prefixed region codes; requires the GeoIP libraryregion="US-CA" | Manual | PRO |
postal_code | Postal codes or ranges; requires the GeoIP librarypostal_code="12300-12500" | Editor button | PRO |
tag | Joomla tag IDstag="12,15" | Editor button | PRO |
component | Component namescomponent="com_content" | Editor button | PRO |
template | Template name or template style selectiontemplate="cassiopeia" | Editor button | PRO |
url | URL or part of a URLurl="/news" | Editor button | PRO |
php | PHP code returning true or falsephp="return true;" | Editor button | PRO |
condition | Condition Set ID, name, or aliascondition="Legal Pages" | Condition Set selector | Free & Pro |
Combining and Excluding Rules
Different attributes must all match by default. Add matching-method="any" to accept any matching rule. Use ! at the beginning of a selection value to exclude it, or false for a boolean rule:
{show menu_item="!101,102" device="mobile"}Mobile content outside these menu items.{/show}
{show home_page="false"}Content outside the home page.{/show}
A comma-separated selection normally accepts any selected value. Access levels, user groups and tags also support + between values to require all of them. Use ALL between exclusion rules when every exclusion must hold; ANY passes as soon as one rule matches.
Additional Inline Settings
The following settings can be entered manually alongside the corresponding rule. They are not separate conditions. Use 0 and 1 for the switches shown below.
| Rule | Additional attributes |
|---|---|
| Menu Items | menu_item_inc_children="1": include children; 2: children only; 0: selected items only. |
| Date | date_recurring="1": repeat the date range each year. |
| Access Levels | access_level_match_all="1": require all selected access levels. |
| User Groups | user_group_match_all="1" requires all selected groups. With matching-any, user_group_inc_children="1" includes child groups; 0 uses the selected groups. Use a Condition Set for child-only selection. |
| Seasons PRO | season_hemisphere="northern", southern, or australia. |
| Categories PRO | category_include_children="0", 1, or 2. Use a Condition Set to select category page types. |
| Article Date PRO | article_date_type="created", modified, publish_up, or publish_down; article_date_recurring="1" repeats the range each year. Date-specific alternatives use their own recurring attribute, such as modified_recurring="1". |
| Tags PRO | tag_match_all="1" and tag_inc_children="0", 1, or 2. |
| URLs PRO | url_casesensitive="1" and url_regex="1". |
For custom fields, use the field's name, such as event_price, rather than its label. Inline comparisons support equality, !=, >, <, >=, <=, and * (contains). For example, event_price=">=25". Use a Condition Set for the additional comparison methods described below. Avoid field names that collide with built-in attributes.
Condition Set Only PRO
HikaShop, FLEXIcontent and Zoo rules must be configured in a Condition Set and require their corresponding extension to be installed. Reference that set with condition="..."; there are no direct inline attributes for these integrations.
Condition Sets also provide grouped ALL/ANY combinations and the full settings interface. An inline attribute supports only the selection and additional settings documented above; the detailed descriptions below show the broader Condition Set interface.
Condition Set Rule Details
Menu Items
Set the piece of content to be included or excluded from any of the available menu items.
Also on Child Items
No matches only the selected item. Yes also matches its child items. Only matches child items but not the directly selected item.
Home Page
Unlike selecting the home page (default) item via the Menu Items, this will only match the real home page, not any URL that has the same Itemid as the home menu item.
This might not work for all 3rd party SEF extensions.
Date & Time
The date and time rules use the date/time of your servers, not the ones of the visitor's system.
Date
You can make the rule pass Before/After a specific date or, with the "Between" option, in a date range between two dates.
With the "Recurring" option, you can also select to apply the date range every year (so the year in the selection will be ignored).
Seasons PRO
You can choose from these options:
Winter, Spring, Summer, Fall / Autumn
You can also select the hemisphere your website is located in:
Northern, Southern, Australia.
Months PRO
You can choose from these options:
January, February, March, April, May, June, July, August, September, October, November, December
Days of the week PRO
You can choose from these options:
Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
Time PRO
You can make the rule pass Before/After a specific time or, with the "Between" option, in a time range between two times.
Format: 23:59
Joomla! Content
This rule is based on what Joomla content page is displayed, including Page Types, Categories, and specific Articles.
Page types PRO
You can choose from these options:
Archived Articles, Single Article, List All Categories, Category Blog, Category List, Featured Articles, Create Article
Categories PRO
Set the piece of content to be included or excluded from any of the Joomla categories.
Also on Child Items
No matches only the selected item. Yes also matches its child items. Only matches child items but not the directly selected item.
Page Types
This option allows you further narrow the rule, to make it only pass on certain page types: Categories, Articles, Others.
Articles PRO
Set the piece of content to be included or excluded from any of the Joomla articles.
Featured Articles PRO
Set the piece of content to be included or excluded from Featured articles.
Article Publish State PRO
Set the piece of content to be included or excluded from the available article publish states:
You can choose from these options:
Published, Unpublished, Archived, Trashed
Article Date PRO
Set the piece of content to be included or excluded based on any of these article dates: Created Date, Modified Date, Start Publishing, Finish Publishing
After selecting a Date Type, you can make the rule pass Before/After a specific date or, with the "Between" option, in a date range between two dates.
With the "Recurring" option, you can also select to apply the date range every year (so the year in the selection will be ignored).
Article Authors PRO
Set the piece of content to be included or excluded from articles written by specific authors.
Article Content Keywords PRO
Set the piece of content to be included or excluded from articles containing your specified keywords in the content.
You can also turn on the 'Case Sensitive' option.
Article Meta Keywords PRO
Set the piece of content to be included or excluded from articles containing your specified meta keywords.
You can also turn on the 'Case Sensitive' option.
Article Field PRO
Set the piece of content to be included or excluded based on the value of any Custom Field.
You can compare the custom field value with any of these methods:
Is equal to, Is not equal to, Contains, Contains one of, Does not contain, Begins with, Ends with, Is less than, Is greater than, Matches Regular Expressions, Is Empty
Is Empty does not require a comparison value.
Comparison Method
You can choose between the following comparison methods:
- Equals: the field value should match the exact entered text
- Is not equal to: the field value should not match the entered text
- Contains: the field value should contain the entered text
- Contains one of: the field should contain at least one of the entered values (useful for fields with multiple values such as lists)
- Does not contain: the field value should not contain the entered text
- Begins with: the field value should start with the entered text
- Ends with: the field value should end with the entered text
- Less than: the field value should be less than the entered value (useful for fields containing numbers or dates)
- Greater than: the field value should be greater than the entered value (useful for fields containing numbers or dates)
- Regular Expressions: the field value should pass the entered custom Regular Expression check
As you can see, the possibilities are pretty much endless!
List Fields
For certain custom field types, the custom field value gets stored differently in the database compared to how it's displayed on the site.
When creating "select" field types that can have multiple values - like lists, checkboxes and radio buttons - for each option you specify the text and its option value.
For these, the value you have to enter in the assignment is the option value, not the option text (if you're using Articles Field, the option value is the ID of the desired article).
And if you want to specify multiple values for "list" fields, you can simply separate them by comma (for example apples,bananas to match options Apples and Bananas).
Date Fields
By using the "Less Than" and "Greater Than" comparison methods, you can match any article where a calendar custom field value is set to before or after a certain date.
Relative Dates
And if all of this wasn't enough, you can also use dynamic Relative Dates values to match articles where a custom field value is set to the current day, yesterday, tomorrow, or any other date relative to today.
For example, you could set up an assignment to match any article that has an "Event Date" (custom field) set in the future by using the "Greater Than" comparison method, and entering a value of now().
You can enter any of these Relative Dates and Custom Format as values:
now()ordate()ordate('now')=> return current date and time (2026-10-30 10:10:12)
date('today')=> return current date (2026-10-30)
date('tomorrow')=> return date of tomorrow (2026-10-31)
date('yesterday')=> return date of yesterday (2026-10-29)
date('-1 day')=> return date of yesterday with current time (2026-10-29 10:10:12)
date('+2 days')=> return date of 2 days from now with current time (2026-11-01 10:10:12)
date('-1 week')=> return date from 1 week ago with current time (2026-10-23 10:10:12)
date('-1 month')=> return date from 1 month ago with current time (2026-09-30 10:10:12)
date('-1 year')=> return date from 1 year ago with current time (2025-10-30 10:10:12)
See the full list of the possible Relative Date Values that can be used.
For any relative date value, you can also customize the date format it should use. Here are some examples:
date('today', 'l')=> return today's week day name (Friday)date('today', 'F')=> return current month's name (October)date('today', 'Y')=> return current year (2026)
date('tomorrow', 'Y-m-d H:i:s')=> return date of tomorrow with time 00:00:00 (2026-10-31 00:00:00)
date('yesterday', 'Y-m-d H:i:s')=> return date of yesterday with time 00:00:00 (2026-10-29 00:00:00)
date('-1 day', 'Y-m-d')=> return date of yesterday (2026-10-29)
date('+2 days', 'Y-m-d')=> return date of 2 days from now (2026-11-01)
date('-1 week', 'Y-m-d')=> return date from 1 week ago (2026-10-23)
date('-1 month', 'Y-m')=> return last month in Y-m format (2026-09)date('-1 year', 'Y')=> return last year (2025)
The date format characters that you can use are based on the PHP date function.
Note: All Date Filters will be adjusted correctly according to the Time Zone used on your website.
Visitors
Users PRO
Set the piece of content to be included or excluded based on the logged-in user visiting the page.
Access Levels
Set the piece of content to be included or excluded based on the Access Level assigned to the logged-in user visiting the page.
Match all
Enable Match all to require every selected access level to be assigned at the same time.
User Groups
Set the piece of content to be included or excluded based on the user group assigned to the logged-in user visiting the page.
Match all
Select to only let the rule pass if all the selected user groups belong to the user at the same time.
Also on Child Items
No matches only the selected item. Yes also matches its child items. Only matches child items but not the directly selected item.
Languages
Set the piece of content to be included or excluded based on the site Language used by the visitor.
This Languages rule differs from the core in that it allows a selection of multiple languages.
Devices
Set the piece of content to be included or excluded based on the device of the visitor. Keep in mind that device detection is not always 100% accurate. Users can set up their devices to mimic other devices.
You can choose from these options:
Desktop, Tablet, Mobile
Operating Systems PRO
Set the piece of content to be included or excluded based on the operating system of the visitor. Keep in mind that operating system detection is not always 100% accurate. Users can set up their browsers to mimic other operating systems.
Browsers PRO
Set the piece of content to be included or excluded based on the browser of the visitor. Keep in mind that browser detection is not always 100% accurate. Users can set up their browsers to mimic other browsers
Mobile Browsers PRO
Set the piece of content to be included or excluded based on the mobile browser of the visitor. Keep in mind that browser detection is not always 100% accurate. Users can set up their browser to mimic other browsers
IP Addresses PRO
Set the piece of content to be included or excluded based on the IP Address of the visitor.
You can enter a comma and/or enter a separated list of IP addresses and IP ranges. For instance:
127.0.0.1
128.0-128.1
129
Geolocation
Geolocating is not always 100% accurate. The geolocation is based on the IP address of the visitor. Not all IP addresses are fixed or known.
To be able to use this rule, you need to install the Regular Labs GeoIP library.
Continents PRO
Set the piece of content to be included or excluded based on the Continent of the visitor.
Countries PRO
Set the piece of content to be included or excluded based on the Country of the visitor.
Regions PRO
Set the piece of content to be included or excluded based on the Region / State of the visitor.
Postal Codes PRO
Set the piece of content to be included or excluded based on the Postal Code of the visitor.
You can enter a comma-separated list of postal codes (12345) or postal code ranges (12300-12500).
Miscellaneous
Tags PRO
Set the piece of content to be included or excluded from any of the Joomla tags or tagged pages.
Match all
Select to only let the rule pass if all the selected tags belong to the page at the same time.
Also on Child Items
No matches only the selected item. Yes also matches its child items. Only matches child items but not the directly selected item.
Components PRO
Set the piece of content to be included or excluded from specific Components.
Templates PRO
Set the piece of content to be included or excluded from specific Templates.
URLs PRO
The URL rule allows control over specific pages or groups of pages, with support for Regular Expressions.
You can enter (part of) the URLs to match, by using a new line for each different match.
You can also turn on the 'Case Sensitive' option, or select to treat the value as Regular Expressions.
Custom PHP PRO
This gives you the opportunity to show or hide a piece of content based on anything you can think of. You just need to know what PHP code you should use.
With PHP you can call on all data/information available in the variables, URL, database, etc. And then do your checks on this data. You can control the display by ending the PHP code with a return true or false based on your checks.
For examples and ready-to-use PHP scripts, check out the "Using Custom PHP Conditions" guide.
Other Condition Set
You can also nest another existing Condition Set as part of the current Condition Set.
This allows you to add (or exclude) a set of rules from another Condition Set on top of the current Condition Set.
HikaShop
This rule is based on what HikaShop page is displayed, including Page Types, Categories, and Products.
Page types PRO
You can choose from these options:
Address, Category, Checkout, Order, Contact, Product, Product Form, User Control Panel, User, Downloads
Categories PRO
Set the piece of content to be included or excluded from any of the HikaShop categories.
Also on Child Items
No matches only the selected item. Yes also matches its child items. Only matches child items but not the directly selected item.
Page Types
This option allows you further narrow the rule, to make it only pass on certain page types: Categories, Products.
Products PRO
Set the piece of content to be included or excluded from any of the HikaShop products.
FLEXIcontent
This rule is based on what FLEXIcontent page is displayed, including Page Types, Tags, and FLEXIcontent Types.
Page types PRO
You can choose from these options:
Author's items, Category, Categories, Content item, Favoured Items (category view), Favoured Items (legacy view), My Items, Search, Tagged Items (category view), Tagged Items (legacy view)
Tags PRO
Set the piece of content to be included or excluded from any of the FLEXIcontent tags.
Page Types
This option allows you further narrow the rule, to make it only pass on certain page types: Tags, Items.
Types PRO
Set the piece of content to be included or excluded from any of the FLEXIcontent types.
Zoo
The Zoo integrations are Pro-only.
Page Types PRO
Match Category, Item, Frontpage, My Submissions, or Submission pages.
Categories PRO
Select Zoo categories, choose No, Yes, or Only for child categories, and restrict the rule to Categories and/or Items page types.
Items PRO
Match selected Zoo items.