oo

Creating a Page Template

Available: 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.

Basic page templates are available.

You may also create your own content page templates and widget page templates.

note

For Liferay DXP 7.4+, Page Template Collections are called Page Template Sets in the Liferay UI.

Creating a New Page Template

The steps below show how to create and use widget and content page templates.

  1. Open the Site Menu ( Site Menu ) and navigate to DesignPage Templates.

  2. Select the Page Templates tab.

  3. Click New and create a new page template set to organize your page templates.

    Use the Page Templates tab to create a page template set.

  4. Click Add ( Add page template icon ) and select Content Page Template or Widget Page Template.

  5. Enter a Name.

  6. Click Save.

The new page template appears. Follow the instructions in Building Content Pages to configure your content page template. Likewise, see Widget Pages to create your widget page template.

You can edit the page template at any time by clicking Actions (Actions icon) → Edit next to the page template in the set.

tip

You can preview your newly created page template. In the page templates page, select Actions (Actions Icon) → Preview for 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 you expand your site.

Follow these steps to make a page template from a page:

  1. While editing the page, click Options ( Options ) at the top right corner of the page and select Convert to Page Template

    Click convert to page template in the options menu to turn the page you are editing into a new page template.

  2. In the modal that appears on the screen, select an existing page set or select Save In New Set to create a new page template set for the page template.

    Here, you can set the basic information for your new 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.

  3. Click Save.

The chosen page template set now has a new page template based on the page you are currently editing, as a draft.

important

You must publish this page template draft to use it for 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 follow these steps:

  1. Select Permissions from the page template’s Actions menu ( Actions icon ).

    Allow other users to access newly created page templates while configuring permissions.

  2. Check the View permission for the roles that you want to have access to the page template. If you want any user who can create a page to be able to use the page template, check the View permission for the user role.

  3. Click Save.

Users with the roles specified now have access to the page template.

Propagating Changes for Widget Pages

When creating a page from a widget page template, changes are inherited from the page template by default, so future changes are automatically propagated 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 automatically propagated 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

important

Staging functionality is in maintenance mode as of 7.3 GA1+.

If staging has been enabled, changes to the 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.

Capability: