Layout Template

In this article, you’ll learn how to create a Liferay layout template as a WAR project. To create a Liferay layout template via the command line using Blade CLI or Maven, use one of the commands with the following parameters:

blade create -t layout-template projectName


mvn archetype:generate \
    -DarchetypeGroupId=com.liferay \
    -DarchetypeArtifactId=com.liferay.project.templates.layout.template \
    -DartifactId=[projectName] \

You can also insert the -b maven parameter in the Blade command to generate a Maven project using Blade CLI.

The template for this kind of project is layout-template. Suppose you want to create a layout template project called my-layout-template-project. You could run one of the following commands to accomplish this:

blade create -t layout-template my-layout-template-project


mvn archetype:generate \
    -DarchetypeGroupId=com.liferay \
    -DarchetypeArtifactId=com.liferay.project.templates.layout.template \
    -DgroupId=com.liferay \
    -DartifactId=my-layout-template-project \
    -Dversion=1.0 \
    -Dauthor=Joe Bloggs \

After running the Blade command above, your project’s directory structure looks like this:

  • my-layout-template-project
    • gradle
      • wrapper
        • gradle-wrapper.jar
    • src
      • main
        • webapp
          • WEB-INF
            • liferay-layout-templates.xml
          • my-layout-template-project.ftl
          • my-layout-template-project.png
    • build.gradle
    • gradlew

The Maven-generated project includes a pom.xml file and does not include the Gradle-specific files, but otherwise, appears exactly the same.

The generated WAR is a working layout template and is deployable to a Liferay DXP instance. To build upon the generated layout template, modify the project by adding logic and additional files to the folders outlined above.

« FreeMarker Portlet TemplateModules Ext Template »