Fields

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.

Filtering by Assignee

You can filter object entries by assignee in GET API calls using the assigneeUserExternalReferenceCode parameter.

Use the API to filter by assignee.