Documentation

Asset Library Content

Available: 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.

  1. Open the Global Menu (Global Menu), click on the Applications tab, and click on Asset Libraries.

  2. Click on the name of the desired Asset Library.

This leads to the Library’s menu page. From here, 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.

Click on the desired Asset Library's name to access its dashboard.

Creating Content

To create content in an Asset Library, first go to the Library’s menu page, and click on the desired application. From here, creating content is essentially the same as creating it in a Site. The only differences are its scope and default theme settings.

See Content Authoring and Management articles for more information about creating each type of content.

Note

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 created content in an Asset Library, you can access and display it in connected Sites using Display Page Templates, Fragments, Widgets, and more. Using Asset Library content in your Site is essentially the same as using Site content.

Unlike Sites, Display Page Templates cannot be defined in an Asset Library. Instead, Asset Library content is displayed in connected Sites using each Site’s default Display Page template for the respective content type.

Also, if you want to select Asset Library content in a Site (e.g., when mapping Page fragment fields, or configuring the Asset Publisher), you must set the modal window to include Asset Library content.

For example, when mapping content to a Page fragment, you can use content from an Asset Library by setting the window to include content from Everywhere. You can then search and select the desired asset.

Filter content in the Item Selector to include content from Everywhere.

Alternatively, you can use the breadcrumb in the Select modal window to navigate to Sites and Libraries. From here, you can click on the Asset Library tab, select the desired Library, and click on the content you want to use.

Navigate to Sites and Libraries in the modal window, and click on the Asset Library tab.

Similarly, when publishing content using the Asset Publisher widget, you must set its scope to include content from a specific Asset Library. Then select the content you want to use.

Set the Asset Publisher's scope to include content from a specific Asset Library.

See Displaying Content documentation for more information about using content in your Sites.

Staging Content

Asset Libraries supports 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 with 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 on 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.

Note

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.

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 on Export or Import at the bottom of the page. Then click the Add button (Add button) 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 on the Actions button ( Actions button ) in the Applications bar and selecting Export Templates. See Importing/Exporting Sites 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 automatically deleted from your instance.

Alternatively, you can then manually delete recycled content or restore it to your Asset Library via the asset’s Actions button ( Actions button ).

Manually delete recycled content or restore it to your Asset Library.

See Recycle Bin Overview for more information.