Creating and Managing User Segments

Creating and Managing User Segments

Using Segments you can create different groups of users based on a common set of properties, like user Job Title, or user Language. For a list of the properties you can use to define Segments, see Segments Editor UI Reference. In addition to the exiting properties, you can add Custom Fields for User and Organization groups and use these fields on you Segment criteria.

Compound Segments

Available Liferay DXP/Portal 7.3+

You can combine existing Segments to create a new Compound Segment. The Compound Segment inherits the properties from the Segments it’s based on and updates the members automatically. You can add additional properties to further customize the Compound Segment.

To understand how Compound Segments work, consider the following example. Visitors from the USA and Canada have different needs, so you create two Segments with different properties, one Segment for each country. Later, you create a new standard Segment for North America visitors, where you manually copy the properties of the USA and Canada Segments. When you change the properties of the USA or Canada Segments, the North America Segment doesn’t inherit the changes. You must manually update the North America segment to reflect these changes. However, if you create the North America segment as a Compound Segment, this Compound Segment automatically updates its definition and members when you change the USA or Canada Segments.


You cannot use an existing Compound Segment to create a new one.

Combine two or more segments to create a new Compound Segment

Creating User Segments

These steps describe how to create a new Segment:

  1. From the Site Menu on the left side of the screen, go to PeopleSegments.

    Add User Segments from the People Menu.

  2. Click the Add button (Add).

  3. Click in the top text area and enter a name for your User Segment.


    You can use the flag selector next to the Segment’s name to translate the name of your Segment.

  4. From the Properties area, select the group and property to define your Segment. Drag and drop the Property to the Conditions area.

  5. Configure the Conditions for your segment (see Configuring Segment’s Conditions below).

  6. Click Save.

Configuring Segment Conditions

From the Condition area you have these options:

  • Edit the comparison criteria using the comparison drop-down menu (A).

  • Add or remove Conditions from the same Properties group, using the buttons next to the condition’s name (B).

  • Add conditions using a different Properties group, by dragging and dropping the Property (C).

  • Combine the Conditions with AND and OR operators (D and E).

    Add and combine Conditions to define the Segment criteria.

For the Session Properties, you can configure a list of predefined values using Session Property Vocabularies. This option facilitates the task of defining the segments and eliminates manual entry errors.


Starting from Liferay DXP 7.4 U42+/GA42+, you can create Segments by geolocation. See Segmentation by Geolocation for more information.

As you edit, a count of members meeting the criteria appears at the top of the Conditions area. You can click on View Members to see the list. This helps you determine if you are correctly defining the Segment.

You can view the list of Segment members at any time.

After you create your User Segment, you can see it in the list of User Segments on the Segments page. From here, you can manage the User Segment (edit it, delete it, assign Site Roles, or change the permissions (who can access the User Segment) for it through its Actions Menu (Actions). You can also click on the User Segment’s name to edit it.

You can edit, delete or manage permissions from the actions menu.


You can’t delete a User Segment if it’s used in an experience.