Amazon Translate

Amazon Translate provides neural machine translation for translating content directly from Brightspot.

Installation

Add the Amazon Translate dependency to your build:

Requirements

Requires Brightspot 5.0 or later.

Maven

<dependency>
    <groupId>com.brightspot.translation</groupId>
    <artifactId>aws</artifactId>
    <version>__HIDDEN__</version>
</dependency>

Gradle

implementation 'com.brightspot.translation:aws:__HIDDEN__'

Gradle (Kotlin DSL)

implementation("com.brightspot.translation:aws:__HIDDEN__")

Prerequisites

Before configuring Amazon Translate in Brightspot:

• AWS Account — You need an AWS account with access to Amazon Translate
• IAM Permissions — Configure a role allowing Brightspot access to Amazon Translate. See AWS documentation:
  • Creating a role to delegate permissions to an AWS service
  • Creating IAM policies (console)
• S3 Buckets — Create input and output buckets for translation jobs

Configuration

To configure Amazon Translate:

1. Click > Admin > Sites & Settings > Sites > Global.

2. From the Integrations tab, expand the AWS Translation cluster.

3. Configure the following fields:

   Field	Description
   Credentials	How Brightspot authenticates with AWS (see below)
   Region	AWS region for translation requests. If blank, reads from server configuration.
   Input Bucket	S3 bucket where Brightspot submits translation jobs
   Output Bucket	S3 bucket where Brightspot retrieves completed translations
   Translation Role ARN	AWS role with access to the buckets and translation service
   Disable Translation Update Task	Prevents Brightspot from querying AWS about active translation progress
   All Async Processing	Submit translation jobs asynchronously to reduce active jobs and potential fees
   Task Host	IP address or hostname managing translation jobs. Uses default if blank.

4. Click Save.

Credential options

Option	Description
Default	Uses AWS credentials configured on your Brightspot server
Assume Role	Enter an IAM ARN for Brightspot to assume when submitting jobs. Optionally specify a session name.
Static	Enter an access ID and secret access key directly

Asynchronous processing

Amazon Translate uses asynchronous batch processing. When you submit content for translation:

1. Brightspot uploads content to the Input Bucket
2. AWS Translate processes the content
3. AWS places results in the Output Bucket
4. Brightspot polls for completion and retrieves results

Job limits

warning

Brightspot limits concurrent async translation jobs to 10 at a time. If you submit more translations while 10 jobs are active, they queue until existing jobs complete.

Update task

Brightspot runs a background task every minute to check translation job status. Configure this behavior with:

• Disable Translation Update Task — Stops automatic polling (useful if you're handling updates another way)
• Task Host — In clustered environments, specify which server should run the update task to prevent duplicate processing

Canceling translations

You can cancel in-progress translations from the Translations tab.

To cancel a translation:

1. Open the source content and go to the Translations tab.
2. Find the pending translation.
3. Click Cancel in the Actions column.

Canceling a translation:

• Stops the AWS Translate job (if still processing)
• Marks the translation log as canceled
• Does not incur charges for unprocessed content

Completing setup

After configuring Amazon Translate, complete the general translation configuration to:

• Set available locales
• Configure completion actions
• Enable translation for specific content types

See Also

• Configuration — General translation settings
• Translating Content — How to send content for translation
• AWS Translate Pricing