Install the Smartcat connector for AEM as a Cloud Service

Overview

The Smartcat connector provides integration between Smartcat and Adobe Experience Manager (AEM) as a Cloud Service, streamlining translation and localization workflows. By connecting AEM to Smartcat, you can automate content translation and centralize management, saving time and ensuring consistency across languages.

Steps to install the Smartcat connector

1. Check that the main POM.xml (the public Maven repository where the connector package resides) has a link to the Central Repository

<repository>
    <id>central</id>
    <name>Central Repository</name>
    <url>https://repo.maven.apache.org/maven2</url>
    <layout>default</layout>
    <snapshots>
        <enabled>false</enabled>
    </snapshots>
</repository>

2. Open /all/pom.xml and add this code to dependencies:

<!-- Smartcat connector -->
<dependency>
    <groupId>com.smartcat.aem.connector</groupId>
    <artifactId>smartcat-connector.ui.apps</artifactId>
    <version>1.0.26</version>
    <type>zip</type>
</dependency>

3. Add the connector package as an embedded section to /all/pom.xml

📌 The embedded section must be added to the plugins section, not the profiles one.

<!-- Smartcat connector -->
<embedded>
    <groupId>com.smartcat.aem.connector</groupId>
    <artifactId>smartcat-connector.ui.apps</artifactId>
    <type>zip</type>
    <target>/apps/smartcat-vendor-packages/application/install</target>
</embedded>

4. Add a workspace filter for Jackrabbit FileVault. By default, filter settings are stored in /all/main/content/META-INF/vault/filter.xml. Add this filter to it:

<filter root="/apps/smartcat-vendor-packages"/>

5. Commit all the changes to the branch and push the changes

6. Run the build for AEM as a Cloud Service

After the build completes, the Smartcat connector is installed on your AEM Cloud Service environment.

Connector configuration

💡 Connector configuration is the same as for the on-premise version. See Connector configuration.

Translation process

To learn more about the translation process, see the step-by-step guide on translating your content in Adobe Experience Manager with Smartcat.

FAQs

Is this guide for AEM Cloud Service or on-premise AEM?

This guide is specifically for AEM as a Cloud Service; on-premise AEM installations should follow the separate on-premise connector installation guide.

Where exactly do I add the Smartcat connector dependency?

You add it to the /all/pom.xml file, both as a dependency entry and as an embedded section under the plugins section (not the profiles section) — placing it under profiles is a common mistake to avoid.

Do I need a separate workspace filter for Jackrabbit FileVault?

Yes — you need to add a filter root of /apps/smartcat-vendor-packages to your filter.xml so the connector package installs into the correct workspace path.

Is connector configuration different for Cloud Service vs. on-premise?

No — once installed, configuration is the same as the on-premise version, referencing the same Connector configuration steps.

What's the next step after installing the connector?

Proceed to the translation process guide for translating content in Adobe Experience Manager with Smartcat, which walks through creating and managing translation jobs.