Skip to main content
Deutsch
Submit a request
 

How can we help?

Search

Articles in this section

Acrolinx for AEM On-Premise - Release Notes

  • Updated
Compatibility Matrix
Supported AEM Versions (On-Premise) Supported Maintained Deprecated Support for Acrolinx AI Assistant and Suggestions
AEM Sites 6.5.25.0
AEM 6.5 LTS
AEM Content Fragments 6.5.25.0
AEM Guides 5.2.0		 3.2.2 3.2.1 3.2.0 and earlier 2.3.7 and later
AEM Sites 6.5.24.0
AEM Content Fragments 6.5.24		 3.2.2 3.2.1 3.2.0 and earlier 2.3.7 and later

TIP

Looking for the latest release notes for Acrolinx for AEM as a Cloud Service (AEMaaCS)? You can find them under Acrolinx for AEMaaCS - Release Notes.

★ CURRENT VERSION

Version 3.2.2 (June 2026)

In Acrolinx for AEM integration version 3.2.2, we updated compatibility support for AEM Guides On-Prem (5.2.0).

Improvements

  • Ensured Acrolinx integration works seamlessly with both the new Guides editor and the existing (legacy) editor, with no disruption to existing user workflows.

Previous Versions

Version 3.2.1 (April 2026)

Removal of Deprecated APIs usage

  • Replaced org.json with javax.json
  • Removed PageInfoProvider so the bundle no longer pulls in the deprecated org.apache.sling.commons.json path used for that integration.
  • Updated Sling log factory org.apache.sling.commons.log.pattern to an Adobe-allowed format.

Sites score column (standard column → client script)

As we have removed PageInfoProvider which uses deprecated API and no alternative available from Adobe for its replacements, we needed to switch from standard column rendering to JS based rendering of the column.

UPDATE INSTRUCTIONS

While updating from previous version to 3.2.1. [Irrelevant if uninstalling and reinstalling or new installation.]

Users need to manually delete Acrolinx Column and its renderer from CRX /apps

Delete the following:

  • Directory analyticscolumnrenderer from path /apps/cq/gui/components/siteadmin/admin/listview/columns/
  • Nodes acrolinxScore and acrolinxScoreHidden from /apps/wcm/core/content/common/availablecolumns

    ee1a6516-bf01-4eea-b701-7ce7f027b52b.png
Version 3.2.0 (3 December 2025)
The Focus This patch release addresses a key issue affecting text highlight and replacement behavior in AEM Guides.

Bug fixes

  • Text Highlight and Replacement in AEM Guides
    Fixed an issue where text highlights and replacements didn't function as expected in AEM Guides. Highlights now display correctly, and replacement actions work reliably.
Version 3.1.1 (24 July 2025)

Released 24 July 2025

This patch release focuses on resolving key issues in the Acrolinx for AEM integration and improving overall system stability. It also includes an important compatibility note for AEM Guides.

Bug fixes

  • Improved Replacement Behavior in Guides Author Mode
    Resolved an issue where replacement suggestions in Guides Author mode only applied when the suggested word was manually focused. Replacements now work without requiring user interaction.
  • Configuration Conflict Resolved on Installation
    Fixed an issue where installing Acrolinx 3.1.0 on AEM Cloud overwrote existing JCR configurations, which previously caused issues in other applications and packages.
Version 3.1.0 (7 April 2025)

Summary

Introducing support for AEM Guides v5.0.

Version 2.3.8 (21 August 2024)

Released 21 August 2024

This release, we've got a small improvement and a couple of bug fixes.

Improvements

  • Increased default timeout
    To make sure Acrolinx has time to generate things like AI suggestions, we've increased the default base HTTP_TIMEOUT from 1 second to 2 seconds.
  • Added timeout error message
    You might've seen the error message "Unable to parse JSON." Since this was related to the timeout, we've updated the messaging to make this more clear.

Bug fix

  • Scorecard display issue
    In some cases, you'd see a plain text Scorecard. This was because the the JS and CSS couldn't load through the AEM proxy. We've fixed this.
Version 2.3.7 (24 July 2024)

Released 24 July 2024

This release, we've made a small improvement to column rendering and fixed a bug.

Improvements

  • Acrolinx column always visible
    We've improved the way the Acrolinx column is rendered in the Assets console. It's now always visible and appears as the last column.

Bug Fixes

  • "Get Suggestions" not working
    In some cases, Get Suggestions wasn't working in AEM. We found the issue and fixed it.
Version 2.3.6 (3 January 2024)

Released 3 January 2024

We've fixed an issue that occurred while deinstalling Acrolinx for AEM. The process also removed other package nodes from the CRXDE.

Version 2.3.5 (31 October 2023)

Released 31 October 2023

This release, we've improved the way Acrolinx highlighting works for different component and page properties. We've also fixed a bug.

Improvements

NOTICE

To take advantage of these improvements, you'll need the latest AEM Content Profile.

  • Fewer False Flags
    To reduce false issues, we've improved the way we extract content. These improvements also make it easier to configure Content Profiles.
  • Acrolinx Highlights More Content
    We've made a few improvements under the hood to improve highlighting in the Sidebar.

NOTICE

Acrolinx won't highlight Page Properties components that are hidden behind tabs or aren't visible to the user.

Bug Fixes

  • Error With Find and Replace in Guides
    We fixed a bug where the Acrolinx Sidebar caused an issue in the Find and Replace feature in AEM Guides. Users would get an application error.
Version 2.2.2 (18 July 2023)

Released 18 July 2023

With this service release, we've fixed a bug in AEMaaCS where the Sidebar button wasn't showing. This was a result of the upgrade to the newest AEM Cloud SDK API.

Version 2.2.1 (7 June 2023)

Released 7 June 2023

This service release fixes a bug in AEMaaCS where the Acrolinx menu icon wasn't available in a user's local environment. This meant that the user couldn't launch the Acrolinx Sidebar.

Version 2.2 (16 February 2023)

Released 16 February 2023

This release has a new improvement that allows you to extract more information from custom components. It's also packed with fresh bug fixes.

Platform Support

This version of Acrolinx for AEM works with:

  • Acrolinx Platform 2021.09 or later (AEM on-prem)
  • Acrolinx Platform 2022.10 or later (AEMaaCS)

We developed and tested this version of Acrolinx for Adobe Experience Manager with:

  • AEM On-premise:
    • AEM version 6.5
    • AEM Guides versions 4.0
  • AEMaaCS:
    • Guides version 2022.5.x - 2022.10.x, 2023.3.x

Improvements

Acrolinx Extracts More Information from Custom Components

We've added additional information to the extracted content in AEM. If the component being extracted is visible on the page, an additional attribute visible="true" will be sent along to the platform, otherwise we'll set visible="false".

Based on this attribute, it would be possible to exclude or mark cards as read only. This avoids the confusion of getting card suggestions for issues that aren't visible on the page.

We recommend creating and using custom components in via Adobe's suggested methods.

Bug Fixes

Getting a 404 Error When Using a Custom Path

If you used custom paths to show or hide Acrolinx, you may have gotten a 404 error that prevented all text from being extracted. We've fixed this issue — Acrolinx looks out for custom prefixes before the standard URL.

Error in Saving Acrolinx Allowed Resources

You might have noticed that Acrolinx resources wouldn't save in the configuration. We've fixed that issue in this release.

NOTICE

We've changed the Persistent ID. If you used regex to limit access, you'll need to add it again.

To add the regex again, do the following:

  1. Go to system/console/configMgr.
  2. Open Acrolinx Allowed Resources.
  3. Copy the regex if other than .*. Store it somewhere safe (for example, in notes). If you don't have a customized regex, you can simply update to a new version of Acrolinx Integration.
  4. Update to the new version of Acrolinx and reopen Acrolinx Allowed Resources.
  5. Paste the regex that you saved in Step 3.

DAM List View Was Broken When Installing Acrolinx

When you installed Acrolinx without having AEM Guides installed, the digital asset management (DAM) list view would fail to load. We've removed the dependency on the Guides package so you won't run into this issue again.

Acrolinx Sidebar Wouldn't Always Load on First Try

There was an issue where the Acrolinx Sidebar wasn't loading consistently when writers accessed AEM Guides. When the Acrolinx Sidebar didn't load, AEM Guides appeared blank. This was due to Guides loading a very large JS file. We've taken care of this issue in this release.

Version 2.1.2 (13 October 2022)

Summary

This service release fixes a bug that made it hard to run Acrolinx checks in certain environments.

Platform Support

Acrolinx for AEM should work with older platform versions. However, we recommend you use:

  • Acrolinx Platform version 2021.05 or later

We developed and tested this version of Acrolinx for Adobe AEM with:

  • AEM On-premise
    • AEM version 6.5
    • AEM Guides version 4.0 and later
  • AEMaaCS (see Acrolinx for AEM version 2.0.1):
    • AEM version 2022.05.x
    • AEM Guides (formerly XML Doc add-on) version 2022.5.x

Bug Fixes

Acrolinx Checks Failed

When you tried to run a check in an environment like Apache Tomcat, it would fail. Turns out there was a small encoding issue, but we've fixed this.

Version 2.1.1 (2 September 2022)

Summary

This service release fixes a bug that showed a 404 when you tried to load the Acrolinx Sidebar in the on-premise version of AEM.

Platform Support

Acrolinx for AEM should work with older platform versions. However, we recommend you use:

  • Acrolinx Platform version 2021.04 or later

We developed and tested this version of Acrolinx for Adobe AEM with:

  • AEM On-premise
    • AEM version 6.5
    • AEM Guides version 4.0 and later
  • AEMaaCS (see Acrolinx for AEM version 2.0.1):
    • AEM version 2022.05.x
    • AEM Guides (formerly XML Doc add-on) version 2022.5.x

Bug Fixes

Sidebar Loading Error

When you tried to load the Sidebar in AEM On-premise, you might've seen a 404 message. Turns out a missing context was the culprit. We've since fixed this, so you can go ahead and use our Sidebar again.

Version 2.1 (19 August 2022)

Summary

We've got another release for you, and this one comes with batch checking improvements for the on-premise version of AEM Guides. Learn more about it below.

Platform Support

Acrolinx for AEM should work with older platform versions. However, we recommend you use:

  • Acrolinx Platform version 2021.03 or later

We developed and tested this version of Acrolinx for Adobe AEM with:

  • AEM On-premise
    • AEM version 6.5
    • AEM Guides version 4.0 and later
  • AEMaaCS (see Acrolinx for AEM version 2.0.1):
    • AEM version 2022.05.x
    • AEM Guides (formerly XML Doc add-on) version 2022.5.x

Improvements

Batch Check Your XML Content Faster

Good news — batch checks in the on-premise version of AEM Guides are now even faster. Previously, Acrolinx checked one XML file at a time until all checks in a batch were finished. When you have multiple language servers, AEM now sends check requests to Acrolinx in parallel. That speeds up the the batch checking process.

Acrolinx Score in XML Editor View

When you include an XML document in a Batch Check, the score is now visible in the document itself. You'll see the Acrolinx Score for in the upper right of the document in the XML Editor. Note that Sidebar checks don't influence the score displayed.

NOTICE

Your results might look a little different than they do when you check with a Sidebar Integration. This is because the Sidebar only extracts and checks editable content from the current view. Batch checks, on the other hand, take the content directly from a content repository.

Version 2.0.1 (20 July 2022)

Summary

We're excited to release this new version that supports AEM Guides within AEM as a Cloud Service (AEmaaCS).

Platform Support

Acrolinx for AEM should work with older platform versions. However, we recommend you use:

  • Acrolinx Platform version 2021.03 or later

We developed and tested this version of Acrolinx for Adobe AEM with:

  • AEM On-premise
    • AEM version 6.5
    • AEM Guides version 4.0 and later
  • AEMaaCS
    • AEM version 2022.05.x
    • AEM Guides (formerly XML Doc add-on) version 2022.5.x

Dropped Support

We've dropped support for the following versions of Acrolinx for AEM:

  • 1.7.3 and 1.7.4

Improvements

Added Support for AEMaaCS Guides

The wait is over! We now support AEM Guides within AEMaaCS. You can use it with the Acrolinx Sidebar to make sure that your content is consistent across your organization. Learn more about what you can check.