Design Libraries

Creating and Managing Design Libraries

Liferay DXP 2026.Q3+ Release Feature (LPD-57283)

A design library holds the design resources its connected sites share, so you maintain them in one place instead of in each site.

Creating a library requires the Add Asset Library permission. Without it, New Design Library does not appear.

Creating a Design Library

  1. Open the Global Menu (Global Menu) and click Applications → Design Libraries.

  2. Click New Design Library.

  3. Enter a Name, using 75 characters or fewer. Each library’s name must be unique.

  4. Enter a Description. This field is optional.

  5. Click Save.

    Liferay DXP confirms the library was created and opens it.

    The New Design Library form has a required Name field and an optional Description field.

Viewing the Design Library Home Page

Liferay DXP 2026.Q4+

  1. Open the Global Menu (Global Menu) and click Applications → Design Libraries.

  2. Click the library’s name.

    You must have permission to add at least one type of design resource to access its home page.

The home page has three sections:

Design Assets: A table of the library’s design resources, with the columns Title, Author, Type, and Modified. The table only lists resource types you have permission to add. See Adding Design Resources to a Design Library.

Members: The library’s users and user groups on their respective tabs. The heading displays the combined total of individual users and user groups, rather than the total number of people inside those groups (e.g., Members (3) indicates two users and one group). See Managing Design Library Members.

Connected Sites: The heading shows the number of sites connected to the library (e.g., Connected Sites (2)). See Connecting Sites to a Design Library.

A design library's home page shows the Design Assets, Members, and Connected Sites sections.

Editing Design Library Settings

  1. Open the library and click More Actions (More Actions) → Settings.

  2. Edit the fields you want to change:

    Name: The library’s name, 75 characters or fewer. Renaming the library updates the title shown for it.

    Description: An optional description.

    Group ID: The identifier Liferay DXP assigns the library. You cannot edit this value.

    ERC: The external reference code. Use it to reference the library from the headless APIs, and to match this library to the same library in another environment.

  3. Click Save, or click Cancel to discard your changes.

Settings requires update permission on the library.

Exporting and Importing a Design Library

A design library offers the standard Liferay Archive (LAR) export and import in Liferay DXP. Both actions require update permission on the library.

You can reach them from the library itself or from the list:

  • Open the library and click More Actions (More Actions), then click Export or Import.
  • On the Design Libraries list, click Actions (Actions) on the library’s row, then click Export or Import.

In Liferay DXP 2026.Q4+, the export can also include the library’s page template sets and content page templates when it includes the Page Templates application. Importing the file into a design library recreates them.

Deleting a Design Library

Deleting a library requires delete permission on it. The library’s row Actions (Actions) menu also offers Delete.

Warning

Deleting a design library permanently removes all of its design resources, including its style books, page fragments, page template sets, and content page templates. This action disconnects every site connected to the library and cannot be undone.

A page that used one of the deleted style books keeps rendering. It falls back to its master page’s style book, then to the site’s default style book for its theme.

A page that used one of the deleted fragments keeps rendering it, because each fragment placed on a page holds its own copy of the HTML, CSS, and JavaScript. What the page loses is its link to the library: the fragment leaves that site’s page editor, so you cannot place it again.

  1. Open the library and click More Actions (More Actions) → Delete.

  2. Confirm the deletion.

In Liferay DXP 2026.Q4+, you can delete several libraries at once by selecting their checkboxes on the Design Libraries list, clicking Delete in the toolbar, and confirming the deletion.