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:
- An instance administrator must enable the
LPD-85746release feature flag. See Feature Flags. - Your role must have permission to manage audiences.
- To use a Liferay Data Platform segment in a condition, the segment must already be synced to this instance. See Integrating Liferay Data Platform with Liferay DXP.
Creating an Audience
-
Open the Global Menu (
) and go to Applications → Audiences. -
Click New.
-
Enter a name in the field at the top of the audience builder. A name can contain up to 75 characters.
-
(Optional) Click Settings to expand it.
-
(Optional) Under General, update the audience’s ERC (external reference code). It can’t be empty and must be unique.
-
(Optional) Under Scope, limit the audience to specific sites. See Limiting an Audience to Specific Sites.
-
Use the Attributes Types drop-down to switch between General, Browser, and Custom attributes. Custom only appears when an
audiencesCustomAttributesclient extension is deployed. -
Drag an attribute from the sidebar and drop it in the Conditions area.

-
Select an operator and set a value for the condition.
-
Repeat the three previous steps to add all desired conditions.
You can drag and drop one condition onto another to group conditions.

You can nest conditions up to three levels deep.
-
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 withOR, so at least one must match.You can configure this setting for all conditions and for individual condition groups.

-
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.
-
For name, enter Frequent Buyers on Mobile.
-
Drag Batch Segments from the General attribute type into the Conditions area.
NoteThe Batch Segments attribute only appears when at least one batch segment is synced. A real-time segment appears under Real Time Segments instead.
-
Leave the operator on Contains and select Frequent Buyers for its value.
-
Drag Device Type from the Browser attribute type into the Conditions area.
-
Leave the operator on Equals and enter
mobilefor its value. -
Leave the conjunction bar set to All, so a visitor must match both conditions.
-
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.
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.
-
Open the Global Menu (
) and go to Applications → Audiences. -
Click Actions (
) for the audience, select Edit, and click Settings. -
Under Scope, make sure Make This Audience Available for All Sites is cleared.
-
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.

-
To remove a site, click Remove [Site Name] (
) 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.
-
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
-
Open the Global Menu (
) and go to Applications → Audiences. -
Click Actions (
) for the audience and select Delete. -
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
| Permission | Description |
|---|---|
| Access in Control Panel | Ability to access the application in the Global Menu |
| Configuration | Ability to view and set the application’s configuration options |
| Permissions | Ability to view and modify the application’s permissions |
| Preferences | Ability to view and set application preferences |
| View | Ability to view the application |
Resource Permissions
| Permission | Description |
|---|---|
| Manage Audiences Entries | Ability to create, edit, and delete audiences |
| Permissions | Ability to view and modify an individual audience’s permissions |
| Update | Ability to edit all audiences |
| View | Ability to view all audiences |
Feature Availability
| Feature | Available as Beta | Available as Release |
|---|---|---|
| Audiences | Liferay DXP 2026.Q3 (LPD-85746) | Liferay DXP 2026.Q4 (LPD-85746) |
| Site-Scoped Audiences | - | Liferay DXP 2026.Q4 (LPD-85746) |