This release removes all usage of deprecated Adobe APIs that were flagged by AEM Cloud Manager's Code Quality enforcement step. Customers running Acrolinx for AEMaaCS will no longer see [region-deprecated-api] or [configuration-api] warnings in their Cloud Manager pipeline logs after upgrading to this version.

Deprecated API Removal

The following deprecated API usages have been eliminated:

• Replaced org.json with javax.json -- The org.json library, deprecated by Adobe since April 2021, has been fully replaced with the standard javax.json API (Apache Johnzon implementation), as recommended by Adobe.
• Removed PageInfoProvider -- The PageInfoProvider integration has been removed. This eliminates the bundle's dependency on the deprecated org.apache.sling.commons.json package, which Adobe has marked as unsupported in AEM as a Cloud Service.
• Updated Sling log pattern -- The org.apache.sling.commons.log.pattern configuration has been updated to match Adobe's required format, resolving the [configuration-api] warning.

Behavioral Change: Sites Score Column

As a result of removing PageInfoProvider, the Acrolinx Score column in the AEM Sites list view has been re-implemented using client-side JavaScript rendering.

What changed:

Why this changed: Adobe deprecated PageInfoProvider and does not provide a replacement API. To continue delivering the Acrolinx Score column while remaining compliant with Adobe's API requirements, the rendering was moved to a client-side JavaScript approach. Because the column is no longer registered as a standard AEM column, it cannot be toggled through AEM's column settings and will always be visible in the Sites list view.

Impact: The score column continues to display the Acrolinx Score for each page. There is no change to scoring accuracy or functionality. The column will now always be present in the list view.

How to Upgrade

Update the acrolinx.version property in your project's /acrolinx/acrolinx.installer/pom.xml:

<properties>\n <acrolinx.version>3.2.1</acrolinx.version>\n</properties>

The latest installer template is available from the v3.2.1 tag of the Acrolinx Installer for AEMaaCS repository.

After updating, rebuild and redeploy through your Cloud Manager pipeline. No additional configuration or manual steps are required for AEMaaCS Cloud customers.

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.

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.

We're closing the feature gap between Acrolinx for AEM On-Prem and Cloud. AEM Cloud currently lacks certain On-Prem features, which affects customers on AEMaaCS. By implementing these features in the AEMaaCS integration, we're ensuring a complete Acrolinx experience for all AEM Cloud users.

Feature Parity Scope

• Implement Batch Checking for Site Pages in AEMaaCS Integration
• Enable Sidebar Check in Content Fragments in AEMaaCS Integration

Improvements

AEM Guides 2025.02 Supported - This release introduces compatibility with the latest version of AEM Guides, 2025.02. You can now leverage the updated features and enhancements while maintaining seamless integration with Acrolinx for content governance.

This release introduces improved extraction behavior in AEMaaCS Sites.

Improvements

Improved checking on Sites pages - To make sure you can check more content on your Sites pages, we've changed our extraction method. Acrolinx now checks all content that's rendered on the screen. It also reads all custom components.

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

Improvements

• Increased default timeout - Acrolinx needs time to generate things like AI suggestions, that's why 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 added an error message that makes this clearer.

Bug fix

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

Some bugs popped up since our last release, so we're bringing you a few fixes.

Bug fixes

• Updated service user mapping - User mapping wasn't visible in Acrolinx for a bit. It turns out AEM changed the way it mapped system users, so we needed to make a few adjustments. Mapping is back and aligns with AEM's suggested approach.
• AI Assistant not opening - The AI Assistant wasn't opening in AEM. It turns out there was an issue with the construction of the URL. This is fixed.
• "Get Suggestions" not working - You might've gotten an 5xx error when you tried to use Get Suggestions in AEM. We found the issue and fixed it.
• Missing version info - Version info was missing from our integration. Even though there wasn't an immediate issue, we've added this information to make sure it's accessible.

This release fixes some bugs and adds support for the most recent versions of AEM Guides.

Bug fixes

• Resource consumption issue - When Acrolinx had connectivity issues, the resulting HTTP requests consumed too many resources and made AEM unusable. We've fixed this. There are now default timeouts for outgoing network requests to Acrolinx.
• Broken queue configuration - There was an issue with parsing numbers from the queue configuration. This is now fixed.
• Issue with underscore/lodash library - You may have seen the error _ is not defined. We've removed the dependency that was causing this.

We fixed some issues and took the opportunity to improve the score display in the list view.

Improvement

• Dynamic Acrolinx Score - In the list view, the Acrolinx Score wouldn't show up in the column. We've decided to fix this issue and improve the behavior at the same time. With the new dynamic solution, the score will be visible automatically.

Bug fixes

• Uninstalling issues - We've fixed an issue that occurred when you tried to uninstall Acrolinx for AEM. The process also removed other package nodes from the AEM JCR.
• Moving and renaming assets - We've fixed a bug that prevented you from moving or renaming assets in Sites.

This release has a big new improvement — you can now use Acrolinx Sidebar in AEMaaCS Sites! In addition to that, we've fixed a handful of bugs. Read on for more details.

Platform Support

We recommend that you use:

• Acrolinx Platform 2022.10 or later
• Guides versions 2023.10.0 and 2023.09.0
• AEM Components version 2.23.4
• A new Content Profile — to take advantage of these improvements, you'll need the latest AEM Content Profile.

Improvements

• Sidebar Now Available in Sites - You can now use Acrolinx in AEMaaCS Sites! The best part is that you can use the Acrolinx Sidebar within Sites.
• Acrolinx Highlights More Content - We've made a few improvements under the hood to bring you a better Sidebar experience.

Bug Fixes

• Batch Check Score Not Showing - There was a bug where a user ran a Batch Check in Guides, but the score wouldn't update on the screen. We've fixed this bug so that you can now see the Acrolinx Scores for your documents.
• Acrolinx Icon Distorted - A fix for a bug where the Acrolinx logo appears after the title "Acrolinx" in the tab view.
• Acrolinx Sidebar Not Loading - We fixed a bug where the Acrolinx Sidebar wouldn't load consistently when users tried using it in AEM Guides. When the Acrolinx Sidebar didn't load, AEM Guides appears blank.
• Error With Find and Replace in Guides - We fixed a bug that caused an issue in the Find and Replace feature in AEM Guides. Users would get an application error.

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

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 AEMaaCS works with:

• Acrolinx Platform 2022.10 or later

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

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

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.

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.