Blogs
We are pleased to announce the release of Liferay Portal 7.4 GA129 and Liferay Commerce 4.0 GA129!
Jamie Sammons
Download options
Liferay Portal and Liferay Commerce share the same Bundle and Docker image. To get started using either Liferay Portal or Liferay Commerce, choose the best download option suited for your environment below.
Docker image
To use Liferay Portal 7.4 GA129:
docker run -it -p 8080:8080 liferay/portal:7.4.3.129-ga129
Bundles and other download options
If you are used to binary releases, you can find the Liferay Portal 7.4 GA129 and Liferay Commerce 4.0 GA129 release on the download page. If you need additional files (for example, the source code, or dependency libraries), visit the release page.
Dependency Management
For development using the Liferay Platform, update Liferay Workspace to use the lat est dependencies, by adding the following line to the build.gradle file:
dependencies {
compileOnly group: "com.liferay.portal", name: "release.portal.api"
}
All portal dependencies are now defined with a single declaration. When Ausing an IDE such as Eclipse or IntelliJ all apis are immediately available in autocomplete for immediate use.
By setting a product info key property it will be possible to update all dependencies to a new version by updating the liferay.workspace.product property in the liferay workspace projects gradle.properties file:
liferay.workspace.product = portal-7.4-ga129
When using an IDE such as Eclipse or IntelliJ all apis are immediately available in autocomplete for immediate use.
Features
Commerce
Returns
Feature Status: Release
This new feature allows streamlined return processes for both buyers and sellers.
Buyers can easily initiate return requests directly from their order history, specify the reason for the return and request a refund.
Returns Managers, within the Returns admin pages, can review the return details, communicate with customers, and issue refunds with just a few clicks.
Documentation: Returns
External Reference Codes Adoptions and Improvements
Feature Status: GA
External Reference Code is now supported in Roles, Specification Groups, Specification Labels and Addresses.
It is also now possible to use the ERC to update and delete these entities via their headless APIs.
Additional ERC support for linked entities has been added when creating new Options, SKUs, Accounts, Catalogs, Orders, Shipments and more.
Documentation:
Liferay-PayPal Checkout Integration
Feature Status: GA
Customize Your Checkout Experience: one integration, multiple payment methods.
Elevate your online store and
give to your buyers a personalized and streamlined checkout
experience. Expand payment options beyond credit cards – Offer Pay
Later, Venmo, and popular regional methods like Bancontact, eps, and
iDEAL to enhance customer satisfaction. Build trust with secure
transactions, all managed within your existing platform.
Perfect
for: Marketplaces, Ecommerce & Shopping Carts, Sharing & Gig
Economy, Tech Partners & Payment Providers and Crowdfunding.
Documentation: Liferay Commerce Connector to PayPal SDK
Enable filter by Custom Field for Products
Feature Status: GA
This feature enables granular product filtering based on custom fields to enhance admin/practitioner efficiency and user experience so that they can easily find what they are looking for.
Documentation: Product Delivery API Basics
Enable filter by Custom Field for Users
Feature Status: GA
This feature enables granular user filtering based on custom fields to enhance admin efficiency and targeted outreach.
Documentation: Filtering, Paginating, Searching, and Sorting Orders
Exposed lastlogindate in the admin UI and in the APIS
Feature Status: GA
This feature allows the admins to filter users by the last time they logged in on the platform, so they can take actions based on this information.
We track lastLoginDate on the User record and now we enable admins to filter them in the User management table and also in the APIs.
Documentation: Managing Users
Commerce Classic Site Initializer + New Order Pages Experience
Feature Status: Beta
Commerce Classic is a new Site Initializer based on the Liferay Classic theme.
The order pages have been redesigned using a Display Page Template for the Order with Fragments, overall offering greater flexibility and customization options. This allows for more dynamic and personalized order experiences.
The new Order Pages now enables the users to select shipping and payment options directly from the order page. Once all required information is filled in, users can quickly checkout with a single click, streamlining the purchasing process.
Documentation:
Minium 4 Site Client Extensions
Feature Status: GA
A new version of our Minium Theme arrived!
With a fresh look and style, the new version of our B2B-optimized site comes in as a collection of 3 Client Extensions that, once installed in your instance, provide the B2B Commerce site ready for use in your environment.
Minium 4 is based on the new Commerce Classic Site Initializer, and shares and will share the new capabilities and improvements.
Documentation: Using the Minium 4 Theme
Content Management
Resolution and Aspect Ratio filters for content dashboard
Feature Status: GA
Users can now easily filter images and videos by resolution (small, medium, large) or aspect ratio (wide, tall, square) directly from the Content Dashboard. This enhancement streamlines the process of finding specific content based on visual criteria, improving efficiency in managing media assets.
Documentation: Filter Options Reference
Improvements in friendly URL for assets
Feature Status: Release
Users can select and reorder categories for a blog’s friendly URL, so they can preview the order of the categories in the friendly URL.
Documentation: Customizing the Blog
Entry’s Friendly URL
Autosave draft in Web Content editor
Feature Status: Release
The Web Content Editor now includes an autosave feature that automatically saves changes in real-time as users edit, storing the content as a draft. This also allows users to easily undo or redo changes as needed. With this enhancement, manual saving is no longer necessary, ensuring continuous backup of content and minimizing the risk of data loss. Content creators can now focus on their work without the worry of losing progress or facing interruptions.
Documentation: Using the Auto-Save, Undo/Redo, and History Features
External Reference Codes applied to Blogs and Documents
Feature Status: GA
External reference codes are now generated for Blogs Images and Document Shortcuts.
It is also now possible to use the ERC to update and delete these entities via their headless APIs.
Documentation:
Allow Instance scope for settings Autogenerate Structure Key and Autogenerate Template Key
Feature Status: GA
The configuration settings for "Autogenerate Structure Key" and "Autogenerate Template Key" have been moved from their previous location in System Settings > System Scope > Administration to a more instance-specific location under System Settings > Web Content > Virtual Instance Scope > Web Content, appearing as the first options after "Custom Token values." These options allow instance admins to control whether structure and template keys are automatically generated at the instance level.
Documentation: Setting the Web Content Structure Key
Liferay AI-Content Wizard
Feature Status: Beta
The AI Assistant is a versatile and powerful tool designed specifically for content creators to enhance their productivity and streamline workflows. By centralizing AI-driven content creation into a single, easy-to-use application, the AI Assistant simplifies the process of generating and managing diverse types of content. Whether you're working on blogs, Knowledge Base articles, or page layouts, the AI Assistant offers the tools and flexibility to help you work smarter and faster—all in one place.
Availability: The AI Assistant is a cloud-based application readily accessible on the Marketplace, making it easy to integrate into your existing digital ecosystem. Its cloud infrastructure ensures reliable performance and scalability, providing users with consistent and seamless access to its capabilities.
Documentation: Liferay AI Content Wizard
Site Management
Enhanced Safeguards for Publications
Feature Status: Release
Enhanced User Safety and Transparency in Publications. We've implemented safeguards to guide users through complex interactions and provided clearer information about changes in the Review Changes screen.
Documentation:
Additional Context in Publications Toolbar
Feature Status: Release
Smoother Workflow for Publication Editors. The new toolbar offers real-time insights to help editors stay focused and efficient. We've improved the toolbar to provide essential context, including current publications, potential conflicts, and change history.
Documentation:
Publication Email Notifications
Feature Status: Release
Enabling users to be notified externally by allowing email notifications when a new user is assigned to a publication.
Documentation:
Page Management
Facilitating Fragment Organization with Drag & Drop and Multi-Selection
Feature Status: Beta
Boost Liferay’s platform with drag-and-drop, multi-selection, and cut/copy/paste features for easier field and fragment organization.
Documentation:
Support Multistep Experiences In The Page Editor
Feature Status: Release
Create smooth multistep forms directly in the page builder with
Liferay’s new fragment—making complex processes simple and
intuitive!
Liferay DXP makes it easy to create dynamic, multi-step
forms. Simply add a stepper fragment to any existing form to transform
it into a multi-step journey. You can then organize your form into
different steps, moving inputs between them as needed. Users can
easily navigate through the steps using the step menu or form buttons,
which you can customize to fit your needs.
Documentation: Using Fragments to Build Multi-Step Forms
Platform Experience
Enable Javascript Client Extensions for Administration in SaaS Environments
Feature Status: Release
Enable JavaScript Client Extensions within SaaS environments to enhance customization and flexibility for administrative tasks, allowing tailored solutions directly within the platform.
Documentation: Use the Client Extension throughout the Instance
Allow theme CSS client extension creators to reference images included in the base theme
Feature Status: Release
or customers, this feature ensures that theme CSS client extensions "just work" out of the box when referencing images from the base theme. It reduces friction in the development process, increases reliability, and provides a more seamless and predictable experience when customizing their Liferay environments.
How it does this:
Simplified Image Management:
-
Developers no longer need to manually handle or configure paths for images included in the base theme.
-
Relative paths (e.g.,
../images) can now directly reference these images, reducing complexity and errors.
Out-of-the-Box Compatibility:
-
The feature ensures that theme images are automatically included during the build process via the
assemblestep. -
This means that after deploying the theme CSS client extension, image references work seamlessly without additional configuration.
Documentation: Using a Theme CSS Client Extension
Search
Semantic Search Support for Documents and Media
Feature Status: Beta
Semantic Search now supports the Documents and Media type. Text embedding generation can be enabled via the provider configuration.
Please note that the provider
configuration is now located under
Control Panel -
Configuration Instance Settings > Search > Semantic Search (Beta).
Documentation: Introducing the Semantic Search Capabilities (BETA) in DXP 7.4 U70+
OpenSearch 2.x Connector (Marketplace)
Feature Status: Beta
The upcoming Marketplace release of the Liferay Connector to OpenSearch 2.x will provide an alternative to Elasticsearch for Self-Hosted Liferay deployments.
IMPORTANT: Please note that the Liferay Enterprise Search Learning to Rank, Cross-Cluster Replication, and Monitoring applications are not compatible, and thus not supported with OpenSearch.
Documentation: OpenSearch
Synonyms Support for More Languages
Feature Status: GA
Synonym Sets now also supports the following languages (locales) out of the box:
-
Portuguese (Brazil):
pt_BR -
Portuguese (Portugal):
pt_PT -
Italian:
it_IT -
Arabic (Saudi Arabia):
ar_SA -
Catalan (Spain):
ca_ES -
Catalan (Andorra):
ca_AD -
Catalan (Spain, Valencian):
ca_ES_VALENCIA -
Chinese (China):
zh_CN -
Chinese (Taiwan):
zh_TW -
Dutch (Netherlands):
nl_NL -
Dutch (Belgium):
nl_BE -
Finnish (Finland):
fi_FI -
French (France):
fr_FR -
French (Canadian):
fr_CA -
German (Germany):
de_DE -
Hungarian (Hungary):
hu_HU -
Japanese (Japan):
ja_JP -
Swedish (Sweden):
sv_SE
Administrators are advised to review the Elasticsearch connector configuration and remove any customized field mappings and settings added previously for the above locales from the Override Type Mappings and the Additional Index Settings as now they are provided by the platform out-of-the-box. (Requires a Full or Concurrent Reindex!)
Documentation: Synonym Sets
Enhanced Search Capabilities with Date Range and Range Aggregations
Feature Status: GA
The new Date Range and Range aggregation types unlock powerful search capabilities for your Liferay assets, including Web Content Structures and Objects. By configuring any date or numeric index field, you can:
-
Group and Filter Results: Create dynamic search filters based on specific dates or numeric ranges.
-
Customize User Experience: Offer flexible search options with predefined ranges or custom input fields.
-
Visualize Data Effectively: Leverage out-of-the-box display templates for a seamless user interface.
Think of Date Range as a versatile extension of the Modified Facet. You can now select any desired date field to refine search results precisely.
Note: The functionality of the Date Facet widget was introduced under a Developer Feature Flag in
2024.Q1 has been integrated into the Custom Facet and is now available as GA. The Date Facet widget is no longer available.
New aggregation types in Custom Facet
Ranges configurations for Date Range aggregation
Range configurations for Range aggregation
Enhanced default display styles for all aggregation types
Documentation: Custom Facet Examples
Improved Disk Space Utilization for Elasticsearch and OpenSearch Deployments
Feature Status: GA
To reduce disk space usage on the search engine side, we've optimized default field mappings which no longer use stored fields. Instead, the platform uses the fields parameter as the default document field retrieval method.
Important Considerations for Administrators:
-
Review Advanced Settings: Administrators should carefully examine the "Additional Type Mappings" and "Override Type Mappings" settings within the search engine connector configuration.
-
Compare with Defaults: After reviewing the advanced settings, compare the existing mappings to the new defaults to identify potential adjustments. While stored fields are still supported, they are not recommended.
Potential Impact on Custom OSGi Modules:
While most users should experience seamless transitions, developers of custom OSGi modules that utilize Liferay's Java Search APIs may encounter changes in search response behavior. This could occur if the modules rely on specific fields being included in the search response. In such cases, developers may need to make adjustments to their modules to ensure correct functionality.
Documentation: Advanced Configuration of the Liferay Elasticsearch Connector
OpenAI Text Embedding Provider for Semantic Search
OpenAI can now be configured as a Text Embedding Provider for Semantic Search.
OpenAI offers two powerful third-generation embedding models promising lower costs, higher multilingual performance, and stronger overall performance compared to the predecessor models.
If your organization is already utilizing OpenAI's ChatGPT or other OpenAI Platform APIs, now you can take advantage of OpenAI's Vector Embeddings capability to deliver semantically more relevant search results through Liferay's semantic search feature (BETA) without the need to sign up for another service.
Documentation: Setting Up a Text Embedding Provider
Frontend Infrastructure
Include Sorting capabilities for List and Cards
Feature Status: Beta
The Data Set Manager sorting tab has changed its purpose. From now on, the sorting options created under this section will be added to an Order Drop Down that is added to the Management Bar. In this way, the users will be able to sort by different criteria, even if those criteria are not visible in the Data Set items.
Documentation: Data
Set Sorting
Enable Admins to Data-Changing Interactions through Data Set Actions
Feature Status: Beta
Admins can now leverage Data Set actions to send targeted requests to a specified endpoint. This enables dynamic updates to persisted objects, such as changing a user's status to "Inactive." While the request body content is currently static, this powerful feature provides a flexible way to manage and modify data within your system.
Documentation: Data Set Actions
Enhanced Data Set Flexibility: Tailor Endpoint Responses
Feature Status: Beta
Data Sets now offer even greater customization power. Admins can directly add manual query parameters to the endpoint URL, enabling fine-grained control over data retrieval. This flexibility allows you to:
-
Filter Data: Apply specific filters to narrow down the results.
-
Select Fields: Choose the exact fields you want to retrieve.
-
Flatten Responses: Simplify complex data structures.
-
Search for Specific Terms: Find relevant information quickly.
By tailoring the endpoint response, admins can provide a more curated and user-friendly experience for end-users.
Behind the Scenes:
The platform seamlessly reconciles these manual parameters with those generated by:
-
Admin Configuration: Fields and Actions tab settings
-
End-User Interactions: Filter and sort options selected in the UI
This ensures a consistent and efficient data retrieval process.
On top of that, admin users can also add or map fields manually to be displayed in the Data Set, so they will be able to bring the information back for those endpoints that don’t have the fields properly typed in the response.
Documentation:
Expand Filter By capabilities to allow filtering by children fields
Feature Status: Beta
When filtering a set of items on a Data Set, sometimes we will be interested in filtering for a field that is part of a relationship. With this new capability, we enable users to choose to filter by children of complex objects.
Documentation: Selecting the Filter Field
Core Infrastructure
Upgrade Report Improvements
Feature Status: GA
The Database Upgrade Report is now enabled by default and offers
expanded information compared to previous releases.
After
running a database upgrade, check the reports/ directory
for reports about what occurred in the system during the upgrade. The
new upgrade_report_diagnostics file includes further
details to diagnose any possible issues.
Documentation: Upgrade Report
Configurations for default user on Virtual Instances
Feature Status: GA
New properties and configurations have been added to allow
control over the default user created for new virtual instances.
The instance admin user can be defined by the system admin upon
instance creation or be disabled completely. This adds an immediate
additional layer of security to a new virtual instance.
Documentation: Adding a Virtual Instance
Business Process Management
Enhanced Process Builder Version History
Feature Status: GA
This update enhances the transparency and accountability of your Process Builder definitions. By tracking modification dates and user information, you can easily identify changes, troubleshoot issues, and ensure compliance. With this improved version history, you can effectively manage your processes and make informed decisions.
Documentation: Viewing and Restoring Workflow Revisions
Allow Forms users to reference Option Values in lists
Feature Status: GA
Currently, in Liferay Forms, users can customize field labels for ease of reference in the page’s HTML.
Now, users are able to fully customize and reference in the HTML the remainder of the Form.
Provide Collections from System Objects to be used with Display fragments
Feature Status: GA
This new feature allows users to configure Collection Providers based on Liferay System Objects, such as Users and Accounts.
Documentation: Displaying Object Entries with Collections
Headless
Headless updates to allow users to manage attachment fields references in Object Entries
Feature Status: GA
Here we added the capability to expose ERC and Scope for Attachments added to Object Entries. We plan to use this during Moving Object entries between environments.
Documentation: Attachment Fields
Embed permissions to Custom and Modifiable System Objects Entries APIs' nested fields
Feature Status: GA
We added the permissions assigned to Custom and Modifiable Object Entries to the Objects Entries APIs' nested fields. This will be useful when we export/import Object Entries with permissions through Batch.
Documentation: Exporting an Object Entry’s Permissions
Application Security
SCIM portal level notification
Feature Status: Release
When the access token is near the expiration date, the portal sends notifications to the System Administrator about it
Documentation: System for Cross-domain Identity Management (SCIM)
Documentation
All documentation for Liferay Portal and Liferay Commerce can now be found on our documentation site: learn.liferay.com. For more information on upgrading to Liferay Portal 7.4 GA129 see refer to the Upgrade Overview.
Compatibility Matrix
Liferay's general policy is to test Liferay Portal and Liferay Commerce against newer major releases of operating systems, open source app servers, browsers, and open source databases (we regularly update the bundled upstream libraries to fix bugs or take advantage of new features in the open source we depend on).
Liferay Portal 7.4 GA129 and Liferay Commerce 4.0 GA129 were tested extensively for use with the following Application/Database Servers:
Application Server
-
Tomcat 9.0
-
Wildfly 26.1
Database
-
MySQL 5.7, 8.0
-
MariaDB 10.2, 10.4, 10.6
-
PostgreSQL 12.x, 13.x, 14.x, 15.x, 16.x
JDK
-
Oracle JDK 17
-
Oracle JDK 21 (recommended)
-
All Java Technical Compatibility Kit (TCK) compliant builds of the respective Java major versions are certified
Search Engine Compatibility Matrix
Source Code
Source is available as a zip archive on the release page, or on its home on GitHub.
Bug Reporting
If you believe you have encountered a bug in the new release you can report your issue by following the bug reporting instructions.
Getting Support
Support is provided by our awesome community. Please visit getting started for more details on how you can receive support.
Fixes and Known Issues
Related Assets...
More Blog Entries...
