Surge Migrate

Removal planned (tentative) 31 December 2027

Moving from Commons Lang 2 to Commons Lang 3 in AEM

Commons Lang 2 has been in maintenance mode for years. Adobe deprecated it on 30 April 2021 and lists a tentative removal date of 31 December 2027.

Affected packages and APIs

  • org.apache.commons.lang.*

What to use instead

org.apache.commons.lang3, which the platform provides.

How to fix it

  1. Change imports from org.apache.commons.lang to org.apache.commons.lang3.
  2. Watch for behaviour changes: StringEscapeUtils moved to commons-text, and some null handling differs.
  3. Run unit tests that cover string utilities.

AEM 6.5

import org.apache.commons.lang.StringUtils;

Cloud Service

import org.apache.commons.lang3.StringUtils;

How we detect it

  • Readiness scan rule commons-lang2: Apache Commons Lang 2.

Best Practices Analyzer reports it under OCU.

Can agents fix it?

High.

Source: Adobe Experience League. Checked 19 October 2026.