Creating Data Lists

Important

Dynamic Data Lists is deprecated as of Liferay DXP 7.3, and is planned for removal in 2024. It is replaced by Objects. Please migrate your Dynamic Data Lists to Objects as soon as possible.

To create a data list:

1. Navigate to Content & Data → Dynamic Data Lists.

2. Click Add () to create a new list.

   Note

   To add Dynamic Data Lists, you must have permission to access the Dynamic Data Lists app in Site Administration.

3. Give the list a name and a description.

   

4. Click Select under Data Definitions to choose a Data Definition.

5. To use a workflow with this list, select it from the Workflow drop-down list.

6. To change the list’s default permissions, expand the form’s Permissions section and make your selections.

7. Click Save to finish creating the list. Your new list appears in the table.

Creating List Records

By default, only administrators have permission to add records to a data list¹. To give other users this permission,

1. Navigate to Content & Data → Dynamic Data Lists.

2. Click Actions () for the list you want to manage. Click Permissions.

   

3. Select Add Record for the Roles that need permissions. To give unauthenticated users permission to add records select Add Record for Guest. Click Save to finish.

New records can be added to a list from Site Administration or from a page that has the Dynamic Data Lists Display widget. See the section below for configuring this widget.

To add a record from Site Administration,

1. Navigate to Content & Data → Dynamic Data Lists.

2. Click on the name of the data list you want to add a record to.

3. Click Add () and a new form opens to add a record.

4. Fill out the necessary fields and click Publish.

To add a record from a page with the Dynamic Lists Display widget,

1. Navigate to the page with the widget.

2. Click Add () and a new form opens to add a record.

3. Fill out the necessary fields and click Publish.

Configuring the Dynamic Data Lists Display Widget

To configure the widget,

1. Start editing the page where the Dynamic Data Lists Display widget has been deployed.

2. Click Options () in the widget header → Configuration.

   

   Note

   Before Liferay DXP 2025.Q1, the Configuration option appeared in the widget’s top-right corner.

3. Select the list to use with the widget by clicking on the name of the Dynamic Data List.

   Click the Optional Configuration tab for additional settings:

   Display Template: Select a display template to utilize. Learn more at Creating Display Templates.

   Form Template: Select a form template to utilize. Learn more at Creating Form Templates

   Editable: Whether users can add records to the widget’s list.

   Form View: Whether to display the Add Record form by default, instead of the List View. Note that even without this selected, users can still add records via the widget’s Add icon (Add).

   Spreadsheet View: Whether the List View displays each record in a row, with columns for the record attributes.

4. When finished with configuration, click Save .

Related Topics

• Getting Started With Dynamic Data Lists

---

1. Documents added in a DDL with the Documents and Media field type do not inherit the permissions of the DDL. Instead, the permissions are defined by the Documents and Media configuration for the uploaded Document. This means that Documents uploaded in a tightly restricted DDL can be more accessible than the DDL records.

   ↩