Publishing Documents

Liferay makes it easy to publish and showcase documents and other types of media files. As you begin uploading media files, you probably want to start sharing them on your site.

The available widgets can highlight your documents and media files: Media Gallery, Documents and Media, and Asset Publisher. You can choose an appropriate widget based on your use case.

You can embed and display Documents and Media files on other assets such as Web Content, Blogs, or Wiki pages.

Using the Documents and Media Widget

This widget provides a way to publish all types of files. Unlike the Media Gallery widget, you can publish documents and other types of media.

  1. From the Content Management section, add the Documents and Media widget to a page.

    Locate the Documents and Media widget listed under the Content Management section of widgets.

  2. If you wish to add additional media files, they can be uploaded from the Documents and Media application.

You can configure Documents and Media via its Options button (Options button):

The configuration window has four different tabs.

Display Settings: Show each file’s actions, show the search bar, show related assets, set maximum number of files per page, and enable different view options.

Folders Listing: Select a Document Library folder to serve as the root folder from which to display files. This folder becomes the highest-level folder the widget can access.

Entries listing for table display style: Set what type of file information to display when the user selects Table view.

Ratings: Enable or disable the ratings system.

The toolbar at the top of Documents and Media provides these functions:

Access different tools from the toolbar at the top of the widget

Checkbox: Select all the media files.

Filter and Order: Filter files by document type. You can also sort your files by different parameters.

Click on filter and order to choose different ways to organize and sort your files.

Reverse: The Reverse icon (Reverse icon) reverses the direction of the sorting.

Search: Search through your media files by keyword.

Information: The Information icon (Click on the information icon to display file info.) provides details about the media files within the folder.

Display Style: The Display Style icon (Click on the display style icon to choose your display option.) switches between three display types: Cards, List and Table view.

Choose between cards, list, or table view to display your files.

Users can choose the display type of their choice.

Selecting a file reveals several options:

Click a checkbox for a file and access additional options.

Clear: Clear your current selection.

Information: The Information icon (Information icon) shows detailed information about the file.

Download: The Download icon (Download icon) downloads the file.

Move: Click the Move icon (Move icon) to move the file to a different folder.

Edit Tags: Click on the Edit Tags icon (Edit icon) to edit the existing tags of a file.

Move to Recycle Bin: Click on the Recycle Bin icon (Recycle icon) to delete a file.

Actions: The Actions icon (Actions icon) has options, including Checkin and Checkout. See Google Drive Integration, Office 365 Integration, and LibreOffice Integration.

Using the Asset Publisher Widget

The Asset Publisher widget can publish different assets and collections based on criteria. You can use it to display content from your Documents and Media library.

Using Documents in Other Assets

It is easy to add your documents or media files to other types of assets:

Web Content

  1. To be able to add documents or media to your Web Content, first create a Structure that contains a field for documents and media.

  2. Go to the Structures tab of the Web Content application to create a new Structure. Drag and drop the Documents and Media field onto the Structure.

    Drag and drop the Documents and Media field onto the Structure.

  3. Under the Web Content tab, click on the Add icon (Add icon) to create new Web Content. Select the Structure you just created as your template.

    Select the new Structure you just created

  4. You can now select documents or media files and add them to your Web Content.


  1. To add documents and media to your blog, first navigate to the Blog application.

  2. Click the Add icon (Add icon) to add a new blog entry.

  3. Under Related Assets, click the Select button to select your documents and media to be added to your blog post.

    Under Related Assets, click on the select button to add your documents or media files.


  1. Navigate to the Wiki node.

  2. Under Related Assets, click on the Select button and to select your documents and media to be added to your Wiki page.

    Under Related Assets, click on the select button to add your documents or media files.