Creating Content Structures
Beta Feature Liferay DXP 2025.Q4+
Currently, this feature is behind a beta feature flag (LPD-17564) and also depends on release feature flags (LPS-179669 and LPD-34594). Read Feature Flags for more information.
Create content structures to define data models for content and files in the CMS. You can reuse existing models or create new ones. It takes only five steps to work with content structures:
-
Create a content structure and configure its fields.
-
Configure the structure’s fields and general options, including field types, labels, mandatory settings, localization, and the spaces where the structure is available.
-
After publishing, customize the structure’s experience to control how users interact with it.
-
Assign workflows to manage content approval, if needed.
-
Manage the structure by editing, copying, exporting, importing, setting permissions, or deleting it.
Creating and Configuring Content Structures
-
Open the Global Menu (
) and click CMS. -
In the left menu, click Content Structures.
-
Click New and choose a structure type: Content or File.
Every content structure starts with a text field called Title. File structures include an upload field called File.
-
In the Content Structure Builder page, enter a title and name for the structure.
-
Set a unique ERC (External Reference Code) for easy reference across Liferay.
-
Under Space Availability, decide where to publish your structure. To select spaces, uncheck Make this content structure available in all spaces, including those yet to be created, and then select the space(s) you want.
-
On the left panel, select from the below field types for the content structure:
- Text, Long Text, Rich Text
- Numeric, Decimal
- Single Select, Multi-select
- Date, Date and Time
- Boolean
- Upload
- Referenced Content Structure (to include an existing structure)
-
Configure each field. See Content Structure Fields Configuration Reference for details.
-
Use the Workflow tab to set a default workflow for the content structure.
-
Click Publish to make the structure available, or click Save to continue editing and publish it later.
The content structure appears under the Contents or Files section, depending on its type.
Customizing Content Structure Experiences
By default, a content structure experience is generated automatically when you publish a content structure. You can preview and edit this experience to control the form’s layout and behavior.
Click Customize Experience at the top of the page to open the page editor.
In the page editor, customizing the content structure experience works the same way as editing a regular page with form fragments. You can add, rearrange, and style fragments to control the form’s appearance and behavior.
See Using Form Fragments for details on available fragments and configuration options. Starting with Liferay DXP 2025.Q4, you can use these fragments in a content structure experience:
| Fragment | Description |
|---|---|
| Accordion | Organizes content into collapsible sections. |
| URL Video Previewer | Displays a video preview from a provided URL. |
| Inline Text | Adds editable text directly within the form layout. |
| Spaces | Shows the spaces where the structure is available. |
| Drag and Drop Upload | Lets users upload files by dragging them into the form area. |
When you finish editing the experience, click Publish. You can see the result by creating an entry with the custom content structure.
Assigning Workflows to Content Structures
You can assign workflows to content structures to control how entries are approved across spaces. Workflow assignment is managed at the through Liferay’s workflow settings.
-
Open the Workflow tab in the content structure configuration.
-
Under Default Workflow, select a workflow to apply to all entries created with this content structure.
This workflow applies to all spaces that use the default workflow setting, including newly created ones.
-
(Optional) Under Workflow Per Space, assign specific workflows to individual spaces to override the default workflow.
If no workflow is selected, entries created from this structure are published immediately without requiring approval.