Upgrade for compatibility with Liferay's Long Term Support (LTS) release for DXP
This is a Release Announcement for a Liferay Faces Update released in October, 2025 for compatibility with the following:
- Liferay DXP 2025.Q1 (see: FACES-3712)
- PrimeFaces 15.0.6 (Liferay Patched, see: FACES-3718)
- Mojarra 2.3.21 (Liferay Patched, see: FACES-3697)
To generate a JSF portlet:
mvn archetype:generate \
-DarchetypeGroupId=com.liferay.faces.archetype \
-DarchetypeArtifactId=com.liferay.faces.archetype.jsf.portlet \
-DarchetypeVersion=8.0.1 \
-DgroupId=com.example \
-DartifactId=my-jsf-portlet \
-Dversion=1.0-SNAPSHOT \
-Dpackage=com.example.portlet \
-DinteractiveMode=fals
To generate a PrimeFaces portlet:
mvn archetype:generate \
-DarchetypeGroupId=com.liferay.faces.archetype \
-DarchetypeArtifactId=com.liferay.faces.archetype.primefaces.portlet \
-DarchetypeVersion=8.0.1 \
-DgroupId=com.example \
-DartifactId=my-primefaces-portlet \
-Dversion=1.0-SNAPSHOT \
-Dpackage=com.example.portlet \
-DinteractiveMode=false
If you build a project generated from one of these archetypes then you will be able to get a local copy of the jar dependencies listed below:
mvn clean package
In order to support "thin" deployments, make sure the following are copied to $LIFERAY_HOME/osgi/modules and not present within the portlet WAR:
- jakarta.faces-2.3.21.LIFERAY-PATCHED-1.jar
- primefaces-15.0.6.LIFERAY-PATCHED-1.jar
- com.liferay.faces.bridge.ext-8.0.2.jar
- com.liferay.faces.bridge.api-6.0.0.jar
- com.liferay.faces.util-4.0.1.jar
- com.liferay.faces.bridge.impl-6.0.1.jar
In order to ensure that they are not present in the portlet WAR, build the generated archetype with the "thin" Maven profile.
mvn -P thin clean package
And combine that with the "cdi" profile in order to take advantage of CDI+OSGi integration:
mvn -P thin,cdi clean package
Issues related to this release:
- FACES-3712: Upgrade to liferay-ce-7.4.3.125-ga125 and liferay-dxp-7.4.13-2024q3 (Testing was performed on 2025.q1.18)
FACES-3718: Upgrade to PrimeFaces 15.0.6 (Liferay Patched) - FACES-3697: Upgrade to Mojarra 2.3.21 (Liferay Patched)
- LPD-54062: Aries CDI is not starting up as an active OSGi module
- FACES-3702: Upgrade to liferay-faces-util-4.0.1
- FACES-3703: Upgrade to liferay-faces-util-3.4.2
- FACES-3704: Upgrade to liferay-faces-showcase-4.0.1
- FACES-3705: Upgrade to liferay-faces-showcase-3.1.2
- FACES-3706: Upgrade to liferay-faces-alloy-4.1.2
- FACES-3707: Upgrade to liferay-faces-alloy-3.1.2
- FACES-3708: Upgrade to liferay-faces-bridge-ext-8.0.2
- FACES-3709: Upgrade to liferay-faces-bridge-ext-7.0.2
- FACES-3710: Upgrade to liferay-faces-bridge-ext-6.1.3
- FACES-3711: Upgrade to liferay-faces-bridge-ext-5.1.3
- FACES-3733: Upgrade to liferay-faces-portal-6.1.0
- FACES-3736: Upgrade to liferay-faces-portal-5.1.0
- FACES-3738: Upgrade to liferay-faces-portal-4.2.0
- FACES-3739: Upgrade to liferay-faces-portal-3.1.2
- FACES-3734: Upgrade to liferay-faces-bridge-impl-6.0.1
- FACES-3735: Upgrade to liferay-faces-bridge-impl-5.0.1
- FACES-3737: Upgrade to liferay-faces-bridge-impl-4.3.1

