Getting started

This guide covers how to include translation capabilities in your Brightspot build.

Dependencies

Include the following dependencies in your build configuration based on your needs:

Core translation (required)

The core translation dependency is required for all translation functionality:

Maven

<!-- Requires Brightspot 5.0 or later. -->
<dependency>
    <groupId>com.brightspot.translation</groupId>
    <artifactId>translation</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle

// Requires Brightspot 5.0 or later.
implementation 'com.brightspot.translation:translation:2.0.0'

Gradle (Kotlin DSL)

// Requires Brightspot 5.0 or later.
implementation("com.brightspot.translation:translation:2.0.0")

warning

This release requires Java 21 or later.

Translation services (optional)

Include dependencies for the specific translation services you want to use:

Artifact	Description
com.brightspot.translation:aws	Amazon Translate integration
com.brightspot.translation:deepl	DeepL integration
com.brightspot.translation:google	Google Translate integration
com.brightspot.translation:lingotek	Lingotek integration

For example, to include Amazon Translate:

Maven

<!-- Requires Brightspot 5.0 or later. -->
<dependency>
    <groupId>com.brightspot.translation</groupId>
    <artifactId>aws</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle

// Requires Brightspot 5.0 or later.
implementation 'com.brightspot.translation:aws:2.0.0'

Gradle (Kotlin DSL)

// Requires Brightspot 5.0 or later.
implementation("com.brightspot.translation:aws:2.0.0")

AI agent tools (optional)

Include this dependency to let an AI agent translate content through the Model Context Protocol (MCP). See AI agent tools for details.

Maven

<!-- Requires Brightspot 5.0 or later. -->
<dependency>
    <groupId>com.brightspot.translation</groupId>
    <artifactId>mcp</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle

// Requires Brightspot 5.0 or later.
implementation 'com.brightspot.translation:mcp:2.0.0'

Gradle (Kotlin DSL)

// Requires Brightspot 5.0 or later.
implementation("com.brightspot.translation:mcp:2.0.0")

Legacy dependencies

Older versions of Brightspot use different dependency coordinates. If you're on an older version, use these dependencies instead:

Artifact	Description
com.psddev:translation	Core translation functionality
com.psddev:translation-aws	Amazon Translate integration
com.psddev:translation-google	Google Translate integration
com.psddev:translation-lingotek	Lingotek integration

For example, the core dependency:

Maven

<dependency>
    <groupId>com.psddev</groupId>
    <artifactId>translation</artifactId>
    <version>4.8.11</version>
</dependency>

Gradle

implementation 'com.psddev:translation:4.8.11'

Gradle (Kotlin DSL)

implementation("com.psddev:translation:4.8.11")

Replace the version with your project's Brightspot version.

What's included

Once you've added the dependencies, the following capabilities are available:

• Translation menu option in content edit pages for sending content to translation
• Translations tab on content for viewing translation history and status
• Site settings for configuring available locales and translation services
• Manual translation option for human-driven translation workflows
• Translation service integrations (if you included AWS, Google, or Lingotek dependencies)

Next steps

1. Configure translation settings for your site
2. Set up your chosen translation service integration (Amazon Translate, Google Translate, or Lingotek)
3. Learn how to send content for translation
4. (Optional) Let an AI agent translate content through MCP.