Audiences

Audience Attributes Reference

Release Feature Liferay DXP 2026.Q3+

Each audience condition pairs an attribute with an operator and a value. There are three attribute types: Browser, General, and Custom.

Browser Attributes

Use Browser attributes to target visitors by their device, browser, and the page they are viewing. Every instance has these attributes.

AttributeValue TypeDetected Value
Browser NamestringThe visitor’s browser, such as Chrome or Safari. Empty when the browser cannot be identified.
Browser VersionstringThe version of the visitor’s browser. Empty when the version cannot be identified.
CookiessetThe cookies set in the visitor’s browser. Each entry is a complete name=value pair.
Device TypestringThe kind of device the visitor is using: console, embedded, mobile, smarttv, tablet, wearable, or xr. Any device that reports none of these is desktop.
Hostname or IP AddressstringThe host of the current page URL, without the port number.
LanguagestringThe language the visitor’s browser is set to, as a tag such as en-US. The audience builder lists the instance’s available locales.
Local DatestringThe current date on the visitor’s device, in YYYY-MM-DD format.
Local HournumberThe current hour on the visitor’s device, from 0 through 23. The audience builder lists 00:00 through 23:00.
PathnamestringThe path portion of the current page URL, without the query string or the fragment.
Referrer URLstringThe page the visitor navigated from. Empty when the browser reports no referrer.
Request ParameterssetThe query string parameters on the current page URL. Each entry is a complete name=value pair.
Time ZonestringThe visitor’s time zone, such as America/New_York.
URLstringThe full URL of the current page, including the query string and the fragment.
User AgentstringThe complete user agent string the browser reports.

General Attributes

Use General attributes to target visitors by their Liferay DXP session and by the Liferay Data Platform segments they belong to.

AttributeValue TypeDetected Value
Batch Segments Liferay DXP 2026.Q4+|setThe Liferay Data Platform batch segments that include the visitor. The audience builder lists all synced batch segments.
Real Time Segments Liferay DXP 2026.Q4+|setThe Liferay Data Platform real-time segments that include the visitor. The audience builder lists all synced real-time segments.
User AuthenticationbooleanWhether the visitor is signed in to Liferay DXP. Select True or False.
User LanguagestringThe language Liferay DXP displays the page in. The audience builder lists the instance’s available locales.
Note

Language and User Language are separate attributes. Language reads the language the visitor’s browser is set to. User Language reads the language Liferay DXP displays the page in. The two can differ.

Batch Segments and Real Time Segments correspond to the two Liferay Data Platform segment types. These attributes only appear when at least one segment of their type is synced. Both support the Contains and Does Not Contain operators. By default, Liferay DXP syncs segments every 60 minutes, so a new segment can take up to an hour to become selectable. To modify this frequency, see Segment Sync Interval. After a Liferay DXP upgrade, previously synced segments appear under Batch Segments until the next sync sets their type.

Custom Attributes

The Custom type appears only when the instance has at least one audiencesCustomAttributes client extension. Each attribute the client extension declares becomes one entry, labeled with the name the client extension gives it, and carries one of four value types: boolean, number, set, or string.

Conjunctions

When you have multiple conditions, you can configure whether a visitor must meet all of them or only some. Selecting All adds the AND operator between each condition, while selecting Any adds the OR operator. Each group of conditions carries its own setting, so you can require every condition in one group while requiring only one in another.

Feature Availability

FeatureAvailable as BetaAvailable as Release
Audience AttributesLiferay DXP 2026.Q3 (LPD-85746)Liferay DXP 2026.Q4 (LPD-85746)
Batch Segments and Real Time Segments-Liferay DXP 2026.Q4 (LPD-85746)