Text classification

The Text Classification feature provides integration with the Amazon Comprehend service to analyze and tag your text content in the Pages app.

Comprehend uses machine learning to find insights and relationships in text. Integrated with Magnolia, those insights are reflected in content tags. This enables editors to quickly grasp the main subject of large quantities of content and search through it more efficiently.

Amazon Comprehend

Amazon Comprehend is fully managed, so there are no servers to provision, and no machine learning models to build, train, or deploy. You pay only for what you use, and there are no minimum fees and no upfront commitments.

Choose what content to analyze

You can choose what text is aggregated and sent to the Amazon Comprehend service for analysis on a Magnolia field level. This enables you to fine-tune the content that is tagged, picking just the field types that make sense for your project. The following Magnolia field types are supported:

If there are terms that you do not want to appear in the tags returned, you can blacklist the terms you don’t want to have in tags. For example, having your company name appear as a tag repeatedly in all your content may not be useful. You can add your company name to the blacklist and it will no longer appear in tags.

You can also set a confidence level to avoid having too many tags that aren’t pertinent to your needs.

Tag content automatically

Save time and effort by moving from tagging items by hand to tagging by machine. Since Magnolia uses a batch service from Amazon Comprehend, you can apply tags automatically to large amounts of content.

Magnolia has chosen to implement the Keyphrase Extraction API feature in Amazon Comprehend. This analysis focuses on finding and extracting returns the key phrases or talking points and a confidence score to support that this is a key phrase.

Using the text classification feature extends the search capabilities of the Find Bar. After the content is analyzed and tagged automatically, those tags are then searchable using the Find Bar.

This provides a more accurate and thorough search experience for your editors.

Multiple language support

Amazon Comprehend can perform text analysis on English, French, German, Italian, Portuguese and Spanish texts.

Note that content tagging currently has an issue when creating tags of words with accented characters. For example, Genève is tagged as Gen-ve. This means that searching for the tag Geneve or Genève will not return any results. The issue is being tracked here: CONTTAGS-69

Triggering classification

The text classification and tagging action are executed during the startup of the author instance. You can also trigger the action manually in the Pages app by selecting one or more pages and clicking the Run classification action.

Pages that have already been tagged are marked as such using a JCR property called lastTaggingAttemptDateByTextClassifier. Executing the manual classification action forces a new tag to be set even if the content was previously tagged.

The text classification feature is available only on author instances.

Managing your tags

Thanks to the text classification integration with the content tags app, the tags are displayed in an additional column in the Pages app.

You can manage the tags directly in the Pages app using a dedicated action: both manually adding or removing tags as required.

Once a page has been tagged, select the page and click the Modify tags action in the Pages app.

In the dialog box that opens, you can type in new tags, remove individual tags or click Remove all tags.


DX Core



This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules