Audiences

Creating and Managing Audiences

Release Feature Liferay DXP 2026.Q3+

An audience is a group of visitors defined by a set of conditions (e.g., the device they’re using, whether they belong to a specific Liferay Data Platform segment). You build those conditions in the audience builder, where you can group them to fine-tune targeting. In Liferay DXP 2026.Q4 and later, you can also limit the audience to specific sites. Once an audience exists, you can create element variations on content pages to personalize parts of the page for the audience’s members.

Prerequisites

Check these requirements before you create an audience:

Creating an Audience

  1. Open the Global Menu (Global Menu) and go to Applications → Audiences.

  2. Click New.

  3. Enter a name in the field at the top of the audience builder. A name can contain up to 75 characters.

  4. (Optional) Click Settings to expand it.

  5. (Optional) Under General, update the audience’s ERC (external reference code). It can’t be empty and must be unique.

  6. (Optional) Under Scope, limit the audience to specific sites. See Limiting an Audience to Specific Sites.

  7. Use the Attributes Types drop-down to switch between General, Browser, and Custom attributes. Custom only appears when an audiencesCustomAttributes client extension is deployed.

  8. Drag an attribute from the sidebar and drop it in the Conditions area.

    The audience builder shows the Attributes Types selector, the attribute sidebar, and one finished condition in the Conditions area.

  9. Select an operator and set a value for the condition.

  10. Repeat the three previous steps to add all desired conditions.

    You can drag and drop one condition onto another to group conditions.

    Two conditions dropped onto each other form a group that keeps its own conjunction.

    You can nest conditions up to three levels deep.

  11. Select All or Any to set how many of the conditions a visitor must meet to belong to the audience.

    All joins conditions with AND, so every condition must match. Any joins them with OR, so at least one must match.

    You can configure this setting for all conditions and for individual condition groups.

    The root conjunction reads Any and joins with OR, while the nested group reads All and joins with AND.

  12. Click Save.

Example: Targeting a Segment on a Phone

Audiences can combine what Liferay Data Platform knows about a visitor with what only the browser can report. Suppose the instance has a Liferay Data Platform batch segment named Frequent Buyers, and you want to reach the members of that segment who browse on a phone.

  1. For name, enter Frequent Buyers on Mobile.

  2. Drag Batch Segments from the General attribute type into the Conditions area.

    Note

    The Batch Segments attribute only appears when at least one batch segment is synced. A real-time segment appears under Real Time Segments instead.

  3. Leave the operator on Contains and select Frequent Buyers for its value.

  4. Drag Device Type from the Browser attribute type into the Conditions area.

  5. Leave the operator on Equals and enter mobile for its value.

  6. Leave the conjunction bar set to All, so a visitor must match both conditions.

  7. Click Save.

When visitors match these conditions, they belong to the Frequent Buyers on Mobile audience and see any element variations targeting this audience.

Limiting an Audience to Specific Sites

Liferay DXP 2026.Q4+

An audience applies on every site unless you limit it to specific sites. The element variations editor on excluded sites doesn’t display the limited audience. You can set the scope when you create an audience or when you edit the audience later.

Warning

Saving a scope that excludes a site removes the audience from that site’s element variations. This includes narrowing an audience from all sites to specific sites. Adding the site back does not restore the audience to those variations.

  1. Open the Global Menu (Global Menu) and go to Applications → Audiences.

  2. Click Actions (Actions) for the audience, select Edit, and click Settings.

  3. Under Scope, make sure Make This Audience Available for All Sites is cleared.

  4. To add a site, select it in Sites and click Add Site to Scope. The site appears in the Scope Sites list. Repeat for each additional site.

    The Scope settings show Make This Audience Available for All Sites cleared and two sites in the Scope Sites list.

  5. To remove a site, click Remove [Site Name] (Remove) in the Scope Sites list.

    If element variations on that site use the audience, a warning says that removing the site stops those variations from applying. Click Remove from Scope to continue or Cancel to keep the site. If no variation on that site uses the audience, the site is removed without a warning.

  6. Click Save.

A variation that loses its last audience to a scope change shows Missing Audience. For information about restoring it, see Fixing Incomplete Variations. If all the sites in an audience’s scope are deleted, the audience applies on every site again, and the audience builder opens it with Make This Audience Available for All Sites selected.

Deleting an Audience

  1. Open the Global Menu (Global Menu) and go to Applications → Audiences.

  2. Click Actions (Actions) for the audience and select Delete.

  3. Confirm the deletion.

Liferay DXP 2026.Q4+ When element variations use the audience, the confirmation dialog indicates how many. Those variations lose the audience but keep their content. A variation left with no audience shows Missing Audience. See Fixing Incomplete Variations.

Audiences Permissions

Working with audiences requires a regular role that has permission to manage them. Because audiences are managed at the instance level rather than in a site, these permissions belong on a regular role. To assign them, edit the role, go to Define Permissions, and open Applications → Personalization → Audiences.

Application Permissions

PermissionDescription
Access in Control PanelAbility to access the application in the Global Menu
ConfigurationAbility to view and set the application’s configuration options
PermissionsAbility to view and modify the application’s permissions
PreferencesAbility to view and set application preferences
ViewAbility to view the application

Resource Permissions

PermissionDescription
Manage Audiences EntriesAbility to create, edit, and delete audiences
PermissionsAbility to view and modify an individual audience’s permissions
UpdateAbility to edit all audiences
ViewAbility to view all audiences

Feature Availability

FeatureAvailable as BetaAvailable as Release
AudiencesLiferay DXP 2026.Q3 (LPD-85746)Liferay DXP 2026.Q4 (LPD-85746)
Site-Scoped Audiences-Liferay DXP 2026.Q4 (LPD-85746)