Using the Web Content Display Widget - Liferay Official Documentation

Submit Feedback

After you create a web content article, the quickest way to display it is the web content display widget. Once displayed in a widget, content updates appear immediately, unless you configure a workflow to review and approve the updates.

Adding Web Content Display to a Page

Go to Site Menu () and navigate to Site Builder → Pages.
Click Actions () next to the page you want to edit and select Edit (alternatively, create a new Content Page).
Click Add () to open the Fragments and Widgets panel.
Under the Content Management category in the Widgets tab, drag the Web Content Display widget to a place on the page.
Click Options () in the widget header → Configuration.

Note

Before Liferay DXP 2025.Q1/Portal GA132, the Configuration option appeared in the widget’s top-right corner.
In Web Content Display Configuration, click Select under the Setup tab.
Select the web content you want to add.

If you organize your content using folders, you can visualize all available content by navigating through the folders. Use the breadcrumbs above the folders and content sections to help your navigation.

Tip

You can search for all content (*) using the search bar. This returns a list with all the available folders and web content on the site.
Set up optional web content display options.
Click Save and close the Web Content Display Configuration dialog.
If you want to publish the Content Page, click Publish.

Note

Web Content Display’s Scope configuration is deprecated as of Liferay DXP 2024.Q4/Portal GA129 and is scheduled for removal in a future release.

After adding a Web Content Display widget to a page, you can set its scope to define the sites and libraries where the content available to be displayed in the widget can be found. For more information about scopes, see Setting Widget Scopes

Click Options () in the widget header → Configuration, then select the Scope tab.

Note

Before Liferay DXP 2025.Q1/Portal GA132, the Configuration option appeared in the widget’s top-right corner.
Click Liferay DXP to open the Scope menu. Here you can select the desired scope for the widget. Click Save.
Click Setup on the tab.
Click Select to open the Select Web Content Menu.
Click Sites and Libraries on the breadcrumb menu.

The available content to be displayed is defined according to the selected scope.

Note

For Liferay DXP 7.3 and earlier, selecting a scope for the Web Content Display widget does not affect the available content to be displayed in the widget.

Web Content Display Setup Options

Note

Web Content Display’s Sharing and Portlet Mode View configurations are deprecated as of Liferay DXP 2024.Q4/Portal GA129 and are scheduled for removal in a future release.

When you have web content selected, you can configure other options in the web content display widget.

To access the widget’s configuration,

Start editing the page where the Web Content Display widget has been deployed.
Click Options () in the widget header → Configuration. The configuration options appear under the Setup tab.

Note

Before Liferay DXP 2025.Q1/Portal GA132, the Configuration option appeared in the widget’s top-right corner.

Template

Option	Description
Use default template	Uses the default template to display the widget. You can see the default template’s name in use here.
Use a specified template	Select this option to display the widget using a different template. You must select the new template.

Option	Description
Translations	Shows additional translations for your content. If you have your content translated into different languages, use this option to show the desired translation.
Print	Provides a print dialog with a print-friendly version of the content.
Download as PDF, DOC, ODT, TXT	Downloads the selected widget content in the format of your choice. This option is only available after configuring the OpenOffice or LibreOffice integration.

Content Metadata

Option	Description
Related Assets	Set this option to show links to other related content. You configure the related content in the Related Assets property for your content (see the image below for an example on a basic web content asset.)
Ratings	Shows a clickable option where users can rate the content in different ways (likes, stars, thumbs up). To configure this rating option for different content types, see Configuring Content Rating Type.
Comments	Allows users to enter comments for the web content display widget’s content. By default, guests can’t leave comments. See Enabling Comments for Guest to change the default option.
Comment Ratings	Shows a rating option for comments.

View Count Increment

Enable the View Count Increment option to add a view counter to this web content display widget.

In addition to the setup options, you can configure additional settings in the web content display widget.

Enabling Comments for Guests

By default, guests can’t leave comments on web content. If you want to allow guests to comment on your web content article,

Open the Global Menu () and navigate to Control Panel → Users → Roles.
Click the Guest role.
Click the Define Permissions column.
From the left menu, select Site and Asset Library Administration → Content & Data → Web Content.
Under the Web Content Article section, check Add Discussion.
Click Save.

You can edit published content directly from the web content display widget when you work with the content page in edit mode.

Click the web content display widget.
In the sidebar panel on the left, click Page Content ().
Click Actions () for the content you want to edit and Select Edit

Integrating OpenOffice or LibreOffice with the Web Content Display

If you enable the OpenOffice / LibreOffice integration with your Liferay portal instance, you can enable document conversion for your content. With this integration, users can download the content in different formats. You must select the available formats under the User Tools configuration for the Web Content Display widget.