Legacy Knowledge Base
Published Jul. 2, 2025

Embedding an HTML Page as a Liferay Portal Page

Written By

Ira Chui

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

This article describes how to use the HTML embed pages functionality. Liferay Portal pages are not just for displaying portlets. Users can also embed HTML documents as pages. It is up to the user to ensure that the CSS, JS, and image paths on their HTML page are correct; the Liferay platform does not validate any HTML or XML pages.

If the HTML page does not appear and instead a Status Not Found error displays, users should check that the URL path is correct.

Resolution

  1. Create or locate a HTML web page that the user wants to embed as a portal page.
  2. Create new a folder that is in the same folder where the ROOT (or its equivalent) folder is located. Place the HTML resource in this folder.
  3. Start Liferay Portal
  4. Navigate to Control Panel > Sites
  5. Create a new site.
  6. Navigate to the new site > Site Pages
  7. Create a new page with the following details:
    1. Name: {page name}
    2. Type: Embedded
    3. URL: http://{URL}:8080/${folder name}/${name of the HTML file} (e.g. http://localhost:8080/test/embedded-page.html)
  8. Navigate to the new site. The first page is the HTML page.

Additional Information

Users might experience truncation when printing the page; no content is printed after the first page. This is a browser specific issue. See https://issues.liferay.com/browse/LPS-16523.

Users cannot use embedded pages as a page template by default.

Did this article resolve your issue ?

Legacy Knowledge Base