Creating a Page Template
Liferay DXP/Portal 7.3+
With page templates, you can create pages based on predefined layouts and content. There are several basic page templates available out-of-the-box. You can also create your own content page templates.
Widget pages and widget page templates are deprecated as of Liferay DXP 2026.Q3 and are disabled by default, so you can neither create a widget page template nor apply one to a new page. Content page templates are unaffected. See Maintenance Mode and Deprecations in Liferay DXP 2026.Q3 for what changes and how to enable the Widget Pages deprecation feature flag.
For Liferay DXP 7.4+, Page Template Collections are called Page Template Sets in the Liferay UI.
Creating a New Page Template
-
Open the Site Menu (
), expand Design, and go to Page Templates.NoteIn the Global site, the application is titled Widget Page Templates, and it is hidden when the Widget Pages deprecation feature flag is disabled and no widget page templates exist.
-
Select the Page Templates tab.
-
Click New and create a new page template set to organize your page templates.
-
Click Add (
) and select Content Page Template.The Widget Page Template option appears only when the deprecation feature flag is enabled.
-
Enter a Name and click Save.
The new page template appears. Follow the instructions in Building Content Pages to configure your content page template. To work with an existing widget page template, see Widget Pages.
You can edit the page template at any time by clicking Actions (
) → Edit next to the page template in the set.
To preview your newly created page template, select Actions () → Preview next to the template you want to preview.
Creating a Page Template from an Existing Page
You can also create a page template from a page while editing it. The new page template keeps all the configurations for fragments and widgets when it is created. This saves you time while expanding your site.
To make a page template from a page,
-
While editing the page, click Options (
) at the top right corner of the page and select Convert to Page Template
-
Select an existing page set or select Save In New Set to create a new page template set for the page template.
If you do not have a page template set, choose a Name and, optionally, a Description for a new page template set. Click Save to save your page as a template in the newly created template set.
-
Click Save.
The chosen page template set now has a new page template based on the page you are currently editing, as a draft.
You must publish the page template draft to use it with new pages.
Sharing a New Page Template
By default, only the creator of the page template can use it. To give other users access to a newly created page template,
-
Open the Page Templates application and select the Page Templates tab.
-
Click Actions (
) for the page template you want to share and select Permissions.
-
Enable the View permission for the roles that should access the page template. For example, enable the View permission for the user role so all users can use the page template.
-
Click Save.
Users with the roles specified now have access to the page template.
Propagating Changes for Widget Pages
When creating a page from an existing widget page template, changes are inherited from the page template by default, so future changes are propagated automatically to the pages that use the page template. Site administrators can disable this behavior through the settings for the individual page.
Propagating Changes for Content Pages
Changes for content pages are not propagated automatically when created using a content page template. However, you can propagate changes to fragments used on a content page. See Propagating Fragment Changes for more information.
Sharing Page Templates With Other Sites
You can share your page templates with other sites using the same process as you would for pages. Follow the instructions in Exporting/Importing Site Pages and Content to learn how.
Staging and Page Templates
If staging has been enabled, changes to an existing widget page template are propagated automatically to the staged page. These changes must still be approved before the page is published to the live site. For this reason, the automatic propagation of widget page template changes to the staged page cannot be turned off and the Inherit Changes selector does not appear.