Asset Library Content
Liferay DXP/Portal 7.3+
Asset libraries provide a convenient way to share content across Liferay sites while streamlining content collaboration and reducing the risk of data duplication. To add, view, and manage an asset library’s content, first navigate to the Library’s menu page.
-
Open the Global Menu (), select the Applications tab, and click Asset Libraries under Content.
-
Click the name of the desired asset library.
Now you can access the library’s active applications to create and manage content. You can also enable staging, implement custom workflows, categorize content using tags and categories, create collections, and more.
Creating Content
To create content in an asset library, first go to the library’s menu page, and click the desired application. From here, creating content is essentially the same as creating it in a site. The differences are mainly its scope and default theme settings.
However, some content requires additional configuration when set within an asset library’s context. Read Categories and Vocabulary to learn more.
See Content Authoring and Management articles for more information about creating each type of content.
Only active applications appear on a library’s menu page. To activate or deactivate an application, see Configuring Asset Libraries for more information.
Using Content in Sites
Once you’ve added content to an asset library, you can access it from connected sites and display it using display page templates, fragments, widgets, and more.
For Liferay 7.4 U21+ and GA21+, when using the item selector in a site, you can browse content (e.g. web content, documents and media, and blogs) in connected asset libraries. To do this, open the item selector window and use the breadcrumb to navigate to Sites and Libraries.
From here, navigate to the Asset Library tab and select a connected asset library. Once selected, you can browse its content and select the desired asset.
Alternatively, you can filter the item selector window to include content from Everywhere. This displays both site content and asset library content.
When publishing content using the Asset Publisher widget, you must set its scope to include content from a specific asset library and select the content you want to use.
See Displaying Content documentation for more information about using content in your sites.
Unlike sites, display page templates cannot be defined in an asset library. Instead, asset library content is displayed using each site’s default display page template for the respective content type.
Staging Content
Asset libraries support both Local Live and Remote Live staging. This provides a working environment for adding, removing, and editing assets in the Web Content or Documents and Media applications before making those changes live. Staged content options are limited to the applications enabled for the asset library. Once enabled, you can then connect the library to staging-enabled sites.
See Using Staging in Asset Libraries for more information.
Categorizing Content
The Tags and Categories applications are enabled for all asset libraries. To access them, navigate to a library’s menu page and click Tags or Categories under Categorization. Tags created in an asset library are scoped to that library and can only be viewed and applied in that context. However, vocabularies and categories defined in an Asset library are immediately available in all connected sites.
If created in an asset library, vocabularies and categories cannot be edited or removed in connected sites. They can only be modified in the asset library in which they were created.
See Tags and Categories documentation for more information about using these applications.
Categories and Vocabulary
Liferay DXP 2024.Q1+/Portal 7.4 GA112+
When creating a vocabulary within an asset library, some additional configurations for categories and vocabularies are available:
-
Open the Global Menu (), go to the Applications tab, and select Asset Libraries under Content.
-
Click the name of the asset library where you want to add your vocabulary.
-
Under categorization, click Categories.
-
Click Add () next to Vocabularies.
-
Configure whether and where that vocabulary is required. You can find the configuration under Associated Asset Types with three options:
Option Description Not Required The vocabulary field is not required. Only Required in This Asset Library The vocabulary field is only required in content created in that asset library. Required in This Asset Library and Its Connected Sites The vocabulary field is required in content created in the asset library and in connected sites. NoteWhen the vocabulary is marked as required, an asterisk marks the vocabulary field, and it must have content or it cannot be saved. Trying to save content without the required vocabulary causes an error message to appear.
Note that when using the Required in This Asset Library and Its Connected Sites option, if a site gets disconnected from the asset library, the vocabulary stops being shown on the content created at a site level. Without the required vocabulary, you can publish content without filling in the vocabulary field.
If a site is connected to an asset library with a required vocabulary, the vocabulary becomes required for the content on that site, and filling in the vocabulary field becomes mandatory. Content cannot be saved without entering the required vocabulary field first.
Exporting and Importing Content
You can export and import asset library content as LAR files. To initiate a new export/import process for a library, go to its dashboard and click Export or Import at the bottom of the page. Then click Add () to initiate a new process.
Exporting and importing library content follows the same process as site assets. You can also create and use custom export templates by clicking Actions () in the application bar and selecting Export Templates. See Exporting/Importing Site Pages and Content for more information.
Removing Content
Asset libraries support the Recycle Bin application. When enabled, any content removed from the library is temporarily stored in its recycle bin. By default, recycled content is retained for 43200 minutes (i.e., 30 days), but you can adjust this period in each asset library’s settings. Recycled content that has been in the recycle bin for more than the allotted time is deleted automatically from your instance.
Alternatively, you can then manually delete recycled content or restore it to your asset library via the asset’s Actions button ( ).
See Recycle Bin Overview for more information.