Content Structures

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.

  1. Open the Global Menu (Global Menu) and click CMS.

  2. In the left menu, click Content Structures.

  3. The list displays all content structures available in the site.

Actions Reference

For each content structure, click Actions (Actions) to access these options:

Edit (Edit): Open the content structure builder to change the structure’s fields, configurations, or availability settings.

View Usages (View Usages): Discover where the content structure is used across spaces.

Export as JSON (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 (Permissions): Define which roles can view, edit, or manage the content structure.

Delete (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.

After creating a content structure, you can manage it from the Content Structures list in Liferay CMS.

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.

  1. On the Content Structures page, click Actions (Actions) next to the page title and select Export.

    Select Export from the Actions menu next to the Content Structures page title.

    By default, the export includes all content structures in Liferay CMS.

  2. Review the export options, and then click Export.

    The Export Content Structures dialog shows the export options for the content structures.

    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.

  3. 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.

Note

You must have a LAR file exported from a compatible Liferay instance before importing.

  1. On the Content Structures page, click Actions (Actions) next to the page title and select Import.

    Select Import from the Actions menu next to the Content Structures page title.

  2. Drop your LAR file into the import area, or click Select File and choose it.

    The Import Content Structures dialog provides options to drop or select a LAR file.

  3. Click Continue.

  4. 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.

  1. On the Content Structures page, click Actions (Actions) next to the page title and select Import from JSON.

    This opens the Import Content Structures dialog.

  2. Click Select File and choose the JSON file. The file must have a .json extension.

    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.

  3. 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.

Important

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.

  1. Select the target content structures.

  2. Click Assign Default Workflow (Assign Default Workflow).

  3. 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.

Assign a default workflow to one or more structures.