Assignee Fields

Liferay DXP 2025.Q4+/Portal 2026.Q1+

Assignee fields are for selecting existing users or roles in the object entry.

Assigned users can edit the entry with no manual permission updates required. If, however, the assignee does not already have view permission, the entry isn’t visible for editing in object displays, and no notifications are sent.

You can add assignee fields to object definitions.

Important

You can use assignee fields with Camunda processes to help manage user interaction tasks from Liferay. For example, if a user must review an entry that’s added by the outbound connector, you can set the status to draft and set the assignee to the user or role that must review the entry. In Liferay you can add a data set filtered by the assignee field and notify assignees when a review is required.

Notifying Assignees

If the object definition includes an assignee field, you can set up a notification action and a notification template to notify assignees. Use the [%OBJECTNAME_ASSIGNEE%] term in the Recipients field.

You can notify assignees.

Using the Assign to Me Action

Object definitions with an assignee field have a system-generated manual action called Assign to Me. You can map a button to this action so users can conveniently claim ownership of a review process.

You can map the Assign to Me action to a button fragment.

Using the Assignee Form Fragment

Liferay DXP 2026.Q4+

The Assignee form fragment maps to assignee fields. With it, you can search users and roles to set the entry’s assignee value. When you perform a search, the fragment returns at most 20 users and 20 roles, and each option appears with an avatar. Once set, the field displays the current assignee.

A published form shows the Assignee field's list of users and roles, each with an avatar.