Publishing Content With Display Pages

Publishing Content With Display Pages

You can use display page templates to create reusable dynamic designs for displaying content items at their friendly URLs. After designing the template, you can make it the default template for displaying its content type, or manually configure only some of your content items to use it. Once set, users can view the content item’s display page by visiting its friendly URL. The content is rendered dynamically according to your template design and mappings. See Using Display Page Templates for more information.


Even though you can create multiple display page templates for the same content type, you can select only one default template. To use an alternative template as the default, you must assign the template to content items individually.

Setting a Default Display Page Template

Follow these steps to set the default display page template for a type of content:

  1. Open the Site Menu (Site Menu) and click DesignPage Templates.

  2. Click the Display Page Templates tab.

  3. Click the Actions button (Actions Button) for the desired template and select Mark as Default


    Each template’s content type is listed under its name (A). The blue check (B) indicates which templates are marked as default.

    Select a display page template as the default one for the content type using the Actions menu.

Setting a Display Page Template for Individual Content Items

Follow these steps to use a display page template for displaying content items:

  1. Open the Site Menu (Site Menu) and go to the desired application (e.g., Web Content, Blogs, Categories).

  2. Begin editing or creating a content item.

    Edit or create a content item.

  3. In the Properties tab, expand the Display Page Template section, click the drop-down menu, and select Specific Display Page Template.


    If you don’t choose a specific display page template, your content is published using the default one for the content type.

    Select a specific display page template to configure it.

  4. Click Select, choose the desired template, and click Done.

    You can preview what the display page looks like with the Preview button located next to the selected display page template.

  5. (Optional) In the Properties tab, expand the Friendly URL panel and modify the friendly URL. This determines the URL for displaying your content item using the display page template.


    For Liferay 7.4 U34+/GA34+, the Display Page Template framework takes into account an asset’s friendly URL history. This means all URLs saved in the file’s URL history redirect automatically to the file’s current URL. The friendly URL history is supported for both documents and blogs.

    You can configure the friendly URL used for your displayed content.

  6. Click Publish.

Once set, Liferay uses the template to display the content item at its unique friendly URL. If desired, you can preview your content’s display page at any time by clicking the content’s Actions button (Actions) and selecting Preview or View Content

Preview displays the content in the display page template context, while View Content redirects you to the content item’s friendly URL.

Preview your content in the context of the display page template or view the Display Page using the content's Action menu.