Poshi Basics New features, improvements, and system upgrades can sometimes introduce unexpected behaviors and bugs. Running suites of automated tests is an advantageous method of identifying issues...

Paths A path is an element on a page that a test will interact with. An element can be a button, text field, link, image, paragraph, or just about anything you would need to assert, click, or type...

Creating the Testcase File Test Scenario Write your first testcase file using the test scenario below: You would like to test that your name does not appear on any learn.liferay.com article. The...

Running a Test Open the poshi-ext.properties file on your poshi-standalone directory and add the following line, replacing the TestCaseFileName#TestCaseName with the one you created in Creating A...

Setup Prerequisites A supported version of Java. Google Chrome. Gradle or Gradle Wrapper 6.6.1 or higher. Setting up the Poshi Standalone Gradle Project Create a new directory, example...

Poshi Advantages Simplified Syntax To make it easier for less technical testers to read and write test automation, Poshi uses a simplified Groovy-like script syntax. It is less wordy than most...

Poshi Layers

Functions In Poshi, Functions handle extra WebDriver commands that an element might require to interact with a page object or element. Functions combine the basic methods defined in the...

Macros A macro is a set of functions that perform a task. Macros are where locators (paths) and functions are brought together to script interactions that a user performs on the system being...

Testcases A testcase file in Poshi is a collection of test scenarios grouped in blocks of code called test blocks. The three main test blocks: setUp, test, and tearDown, are made up of multiple...

Using Variables Though not a Poshi layer, variables are a large part of Poshi tests. Variables, like in other programming languages, are used to store data which can be referenced and reused in...

Poshi Resources To give Poshi test writers easy access to commonly used functions or other files, Poshi resources were created to store existing Poshi files as dependencies that can be loaded apart...

Configuration In order to give test writers easy access to commonly used functions, paths, or macros, Poshi resources were created to store existing Poshi files as dependencies. These resources can...

Using Poshi Resources Once the Poshi resources jar file is loaded onto your Poshi project, you are now able to use Liferay's commonly used functions, paths, and macros. To distinguish between files...

Reference Node Version Information

Node Version Information Liferay DXP uses Node (and NPM) for many different frontend components. Specifically, the Liferay Theme Generator and Liferay's JavaScript application tools require the use...

Liferay Classloader Hierarchy All Liferay DXP/Portal applications live in an OSGi container. DXP/Portal is a web application deployed on your application server. Its Module Framework bundles...

The Benefits of Modularity Dictionary.com defines modularity as the use of individually distinct functional units, as in assembling an electronic or mechanical system. The distinct functional units...

Using the Bootstrap 3 Compatibility Layer in Liferay 7.4 As of Liferay DXP 7.4 GA1, the Bootstrap 3 compatibility layer is removed from the built-in packages in Liferay frontend applications. If...

Architecture The Liferay DXP/Portal architecture has three parts: Core: Bootstraps DXP and its frameworks. The Core provides a runtime environment for managing services, UI components, and...

Building Forms with Conditional Fields Forms can become dynamic forms where the answer to one question may allow the respondent to skip the next three questions, or require the respondent to answer...

Customizing Auto-Save Behavior The Forms application automatically saves the form creation progress as you create a form. By default, a form's draft is auto-saved every minute. To change the...

Customizing Form Layouts By default, new elements on your form are added to a new row and occupy the entire width of the form. Form with all elements occupying entire width of form. Sometimes it...

7.2 Breaking Changes This document presents a chronological list of changes that break existing functionality, APIs, or contracts with third party Liferay developers or users. We try our best to...

7.3 Breaking Changes This document presents a chronological list of changes that break existing functionality, APIs, or contracts with third party Liferay developers or users. We try our best to...

7.4 Breaking Changes Breaking changes break or significantly alter existing functionality or code structure. Here are all of the breaking changes for Liferay 7.4, starting with the latest quarterly...

Exported Third Party Packages Liferay provides over one-hundred third party Java packages at run time. The com.liferay.portal.bootstrap module exports the packages by specifying individual packages...

Low Code

Creating and Managing Forms The Forms application is in maintenance mode as of Liferay DXP 2024.Q4/Portal GA129. Migrate your forms to objects and form container fragments to future-proof your...

Creating Forms You can create multi-field forms with the Forms application. Only authenticated users with the requisite permissions can create forms. At minimum, they should have permission to...

Issue After configuring a virtual host in Liferay DXP 7.3, the /web/guest path segment cannot be removed from the site URL. Accessing the site without /web/guest results in the page continuously loading and a 404...

Issue The category filter fragment only expands or collapses the category list when clicking the dropdown arrow. Clicking the category name itself does not trigger this action. Steps to reproduce:  1. Navigate to any page and open it in edit mode 2. Drag and drop the 'Category filter' on...

Issue We would like to verify if our Liferay instance is vulnerable to CVE-2021-29044 Environment DXP 7.2, DXP 7.3 Resolution Please see if your current patch level is higher than 7.2 FP10, or 7.3 DXP1.  If your current patch level is lower than the above listed, please open a ticket and...

Issue After upgrading to 2025.q1.6-lts, I received the following error in the log: Feature flag LPD-10588 is not available for company 0 Environment Liferay Quarterly Release 2025.q1.6-lts Resolution The case has been addressed and resolved by LPD-56013. Kindly request a hotfix. After...

Issue Issue description: I have enabled a review workflow for an object and noticed that if I want the reviewer to be able to edit the submitted object entry during the review task, I need to add the "Access in Control Panel" permission to the reviewer's role. But that is too much,...

Issue Deploying an EXT extension results in the extension being lost after the environment restarts. Environment Quarterly Releases 2023.Q3.3+. PaaS Resolution The use of EXT modules is discouraged. Please explore alternative extensions before proceeding, if possible. Starting from...

Issue An unnecessary hidden heading, <h1 class="sr-only">Navigation</h1>, is present in the page source code. Although hidden visually, it is still picked up by screen readers, which can confuse users relying on assistive technologies. The entire page content is wrapped in a <div> with...

Issue When attempting to access Analytics Cloud via https://analytics.liferay.com the site hangs indefinitely on the "Redirecting to your identity provider..." message. This can occur despite successfully logging in previously. Environment Analytics Cloud Ad-blocker browser extension...

Issue We have enabled a workflow for approving new user account creation. While the Admin user gets the notficiation about the workflow task, if they navigate to My Workflow Tasks > Assigned to my Roles, the task is not listed there.   Environment 2024.Q3 2024.Q4 2025.Q1 2025.Q2  ...

Issue After configuring settings such as JS or CSS on the pages of a site with Local Staging enabled, the changes are being lost after publishing to Live   Environment 2024.Q1.12 (or older versions)   Resolution This behavior is a known error in the Product and has been fixed on version...