Managing Content Structures
Liferay DXP 2026.Q3+
You can edit published content structures, manage permissions, and move structures between environments from the Content Structures page.
Accessing the Content Structures List
By default, only the CMS Administrator role can access Content Structures.
-
Open the Global Menu (
) and click CMS. -
In the left menu, click Content Structures.
-
The list displays all content structures available in the site.
Actions Reference
For each content structure, click Actions (
) to access these options:
Edit (
): Open the content structure builder to change the structure’s fields, configurations, or availability settings.
View Usages (
): Discover where the content structure is used across spaces.
Export as JSON (
): Download the content structure in JSON format for backups or for moving structures between environments. The export includes the structure’s repeatable field groups and any content structures it references.
Permissions (
): Define which roles can view, edit, or manage the content structure.
Delete (
): Remove a custom content structure and every content item created with it. This action is permanent and cannot be undone. You can’t delete a structure that references another structure or is referenced by one.

Exporting Content Structures to a LAR File
You can export content structures as a LAR (Liferay Archive) file for migration to another environment. Unlike Export as JSON, which exports one structure and the structures it references, this exports all content structures together in one LAR file.
-
On the Content Structures page, click Actions (
) next to the page title and select Export.
By default, the export includes all content structures in Liferay CMS.
-
Review the export options, and then click Export.

The Current and Previous tab opens and runs the export process. When the status shows Successful, a download link for the LAR file appears in the Download column.
-
Click the LAR file to download it.
Importing Content Structures from a LAR File
You can import content structures from a LAR file exported from another Liferay environment.
You must have a LAR file exported from a compatible Liferay instance before importing.
-
On the Content Structures page, click Actions (
) next to the page title and select Import.
-
Drop your LAR file into the import area, or click Select File and choose it.

-
Click Continue.
-
Review the file details and application options, and then click Import.
The Current and Previous tab opens and runs the import process. When it completes, the imported content structures appear in the Content Structures list.
Importing Content Structures from a JSON File
You can import content structures from a JSON file produced by the Export as JSON action. Use a JSON file to move individual structures between environments, and a LAR file to move them all at once.
-
On the Content Structures page, click Actions (
) next to the page title and select Import from JSON.This opens the Import Content Structures dialog.
-
Click Select File and choose the JSON file. The file must have a
.jsonextension.Liferay DXP validates the file as soon as you select it. If the file is not valid JSON, the dialog reports “You have entered invalid JSON” and the import does not run. Select a different file, or export the structure again and repeat this step.
-
Click Import.
Liferay DXP matches structures by external reference code, the identifier stored with each structure, so importing the same file twice updates those structures rather than creating duplicates.
If none of the structures in the file already exist, the import runs immediately, the dialog closes, and the Content Structures list reloads. Each structure imports into the folder it was exported from and is active.
If the file contains structures that already exist, Liferay DXP asks you to confirm the override. The warning names each structure it replaces and notes that you may lose data or need to reindex. Click Import to confirm.
When you override an existing content structure, the import fails if the file drops a repeatable group the existing structure still has. The dialog reports that edge object relationships cannot be deleted, and the structure is left unchanged. To drop a repeatable group, delete the structure and import the new version as a fresh import. Deleting the structure permanently deletes all content created with it.
Managing Workflows in Bulk
You can assign a default workflow to multiple structures simultaneously. The selected workflow becomes the default for these structures across all spaces, including newly created ones.
-
Select the target content structures.
-
Click Assign Default Workflow (
). -
Select a workflow and click Assign Workflow.
You can override the default workflow assignment of a structure in each space. If a structure’s workflow is already set in a space when the default workflow is configured, the space-specific setting takes precedence.
