Liferay Upgrade Program

From the upgrade assessment to go-live. Start with the assessment: identify your version, run the read-only script on your UAT environment and send the report to Liferay.

Why stay up to date with Liferay?

Every release makes your platform safer, faster and easier to build on. Here are the top five reasons to upgrade.

  1. SecurityThe latest security fixes protect your sites, your users and their data. Liferay security
  2. Supported and compliantStay within Liferay's support lifecycle, with fixes and help when you need them. Service life policy
  3. New capabilitiesUse what newer releases bring, such as AI features, Objects, client extensions and low-code tools. Explore the platform
  4. Performance and compatibilityRun on current Java versions, databases, application servers and browsers.
  5. Lower cost of ownershipRetire deprecated features and technical debt, and make every future upgrade smaller.

We're here to help. The Liferay upgrade program takes you from assessment to go-live with Liferay Customer Success, the Liferay Upgrade Team and Liferay Support at your side. It starts with a read-only assessment of your installation, which includes a free Liferay DXP architecture health check (best effort, for reference only). You can stop after the health check (step 3), with no obligation.

Start the assessment Contact Liferay
  1. Phase 1 · Steps 0–4AssessmentReport, health check, qualificationLiferay Customer Success
  2. Phase 2 · Step 5PreparationDeliverables to the Upgrade TeamLiferay Customer Success
  3. Phase 3 · Step 6Core solution upgradePerformed by LiferayLiferay Upgrade Team
  4. Phase 4 · Step 7ValidationUAT testing and fixesLiferay Upgrade Team
  5. Phase 5 · Step 8Go-LiveGo-live, then support for OOTB featuresLiferay Support
Your Liferay contact in each phase: Liferay Customer Success · phases 1–2 Liferay Upgrade Team · phases 3–4 Liferay Support · phase 5
Phase 1

Assessment

Steps 0–4Supported by Liferay Customer Success
Read-only scripts Run on UAT / test only, never on production At your own risk
0

Identify your version

You

Find your Liferay edition and version, then select it below.

  1. Sign in to Liferay as an administrator.
  2. Open Server Administration:
    Your versionWhere to find Server Administration
    6.1Go to > Control Panel > Server > Server Administration
    6.2Admin > Control Panel > Configuration > Server Administration
    7.0 – 7.3Product Menu (top left) > Control Panel > Configuration > Server Administration
    7.4 and Quarterly ReleasesGlobal Menu (grid icon, top right) > Control Panel > System > Server Administration

    Menu names are shown as in English. If your Liferay is set to another language, look for the same menus in that language.

    Or open it directly: https://<your-server>/group/control_panel/manage/-/server/resources (6.x), or https://<your-server>/group/guest/~/control_panel/manage?p_p_id=com_liferay_server_admin_web_portlet_ServerAdminPortlet (7.0 and later).

  3. The version is shown at the top of the page. Examples:
    Shown on the pageSelect
    Liferay Portal Community Edition 6.2 CE GA6Liferay Portal CE 6.2
    Liferay Community Edition Portal 7.4.3.132 CE GA132Liferay Portal CE 7.4
    Liferay Portal Enterprise Edition 6.1.30 EELiferay Portal EE 6.1
    Liferay Digital Experience Platform 7.4.13 Update 92Liferay DXP 7.4
    Liferay Digital Experience Platform 2025.Q1.29 LTSLiferay DXP 2025.Q1 LTS

    The same text is printed in the server log when Liferay starts (look for Starting Liferay).

1

Run the script on UAT

You

Copy the script for your version and run it in the Script console of your UAT / test environment.

Replaces site names, URLs, instance names, host names, e-mail addresses, the database location and installation paths with placeholders such as site-1. All counts stay the same.
  1. Sign in to your UAT environment as an administrator.
  2. Open Server Administration (see step 0) and select the Script tab.
  3. Set Language to Groovy, delete the sample code and paste the script.
  4. Click Execute and wait until the page reloads. On large installations this can take a few minutes; don't click again.
  5. The result appears in the Output box. It starts with "Key", "Value", "Description" and ends with lines starting with "uas_.
No Script tab, no Groovy option, or the script is refused?
  • Sign in as an administrator of the default virtual instance (the first instance created). Server Administration is only available to these administrators.
  • The Script Management setting in System Settings (Liferay DXP 2024.Q2 / Portal 7.4 GA120 and later) only controls scripts in Workflow and Objects. You don't need to change it to run this script.
  • Your organization may have switched off scripting for security, for example by disabling the Groovy scripting module. Ask your Liferay administrator to allow it on the UAT environment for the assessment, and to switch it off again afterwards if that is your policy.
  • If you still can't run it, tell Liferay your version and what you see; we'll help.
2

Save the output as a .txt file and send it to Liferay

You

Save the result on your own computer, then send it to Liferay by e-mail or as a support ticket.

Save the output:

  1. Click inside the Output box, select everything (Ctrl+A / Cmd+A) and copy it (Ctrl+C / Cmd+C).
  2. Windows: open Notepad, paste, then File > Save As and choose Text Documents (*.txt).
    Mac: open TextEdit, choose Format > Make Plain Text, paste, then File > Save.
  3. Name the file <company>_<liferay-version>_upgrade-report_<yyyy-mm-dd>.txt, for example acme_dxp-7.3_upgrade-report_2026-11-02.txt.
  4. Check that the last lines start with "uas_ (for example "uas_end_date"). If some lines contain UAS ERROR, send the file anyway: it tells Liferay what could not be read.

Send it, by e-mail or as a support ticket. Send the report only as an attachment; don't paste it into a website or chat.

Option A: e-mail

  1. E-mail the .txt file as an attachment to support@liferay.com.
  2. Put your Liferay customer success contact in CC, if you know who it is.
  3. Use a subject such as Upgrade assessment report – <company>.
Start the e-mail Opens your e-mail program with the address and subject filled in. Attach the saved file yourself.
Add your company and customer success contact to the e-mail

Option B: support ticket (Liferay subscribers with a Help Center account)

  1. Go to the Liferay Help Center and sign in with your liferay.com account.
  2. Choose Contact Support (or Submit a request) to open a new ticket, and select your project.
  3. Use the subject Upgrade assessment report – <company>, and in the description say that this is the report for the Liferay upgrade program.
  4. Attach the saved .txt file and submit the ticket.
  5. If you know your Liferay customer success contact, let them know the ticket number.

Liferay replies on the ticket and notifies you by e-mail.

The report contains technical details (versions, counts, plugin and site names) but no content from your sites, and the scripts do not read passwords. To hide names and addresses, use the privacy option in step 1.
3

Health check

FREELiferay Customer Success

Liferay reviews your report and carries out a health check of your installation: version, infrastructure, data volumes, customizations and features that are deprecated in newer releases.

With this assessment you receive a free Liferay DXP architecture health check. You can stop after this step: there is no obligation to continue with the upgrade program.

See a sample health check report (PDF, fictitious data)

The health check is provided on a best-effort basis and for reference only. It is based on the output of the read-only script; it is not an audit, a guarantee or a warranty.

Deprecations and breaking changes by release (Liferay Learn)

4

Qualification and agreement

Liferay Customer Success → You

Liferay validates whether you qualify for the Liferay upgrade program. If you qualify, Liferay shares the contractual terms with you for sign-off.

About Liferay subscriptions

Phase 2

Preparation

Step 5Supported by Liferay Customer Success
5

Prepare the deliverables for the Liferay Upgrade Team

You

Prepare the deliverables for the upgrade and hand them off to the Liferay Upgrade Team. Liferay tells you what is needed.

Preparing for an upgrade (Liferay Learn)

Phase 3

Core solution upgrade

Step 6Supported by Liferay Upgrade Team
6

Upgrade execution

Liferay Upgrade Team

After the kick-off, Liferay performs the upgrade of your solution.

The Liferay Upgrade Team confirms the timeline and details after the assessment phase.

How a Liferay upgrade works (Liferay Learn)

Phase 4

Validation

Step 7Supported by Liferay Upgrade Team
7

UAT testing and fixes

You + Liferay Upgrade Team

You test the upgraded solution in UAT; issues found are fixed.

The Liferay Upgrade Team confirms the timeline and details after the assessment phase.

Phase 5

Go-Live

Step 8Supported by Liferay Support
8

Go-Live

You + Liferay Support

The upgraded solution goes live. From then on, support comes from the Liferay Support team.

Liferay Support covers out-of-the-box (OOTB) Liferay features only. Your customizations (custom code, themes, integrations) are not covered by Liferay Support.

Liferay Support coverage areas and hours

↑ Top