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:

• Roles API Basics

• Account Users and Roles APIs

• Postal Address API Basics

• Product API Basics

• Specification API Basics

• Order API Basics

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:

• Using the Commerce Classic Site Initializer

• Order Pages

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:

• Blog API Basics

• Document API Basics

• Document Shortcut API Basics

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:​​​​​​​ ​​​​​​​

• Publications

• Making and Publishing Changes

• Using the Publications Toolbar

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:​​​​​​​ ​​​​​​​

• Publications

• Making and Publishing Changes

• Using the Publications Toolbar

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:

• Configuring Personal Notifications

• Collaborating on Publications

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:

• Adding Elements to Content Pages

• Browser

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 assemble step.

• 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:

• Adding Advanced Parameters to a Data Set

• Adding Fields Manually

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

• Fixes

• List of known issues​​​​​​​