Configuration

This guide covers how to configure translation settings in Brightspot. These settings are common to both manual translation and integrated translation services.

Note

If you're using a translation service like Amazon Translate, Google Translate, or Lingotek, complete the service-specific configuration first, then return to this guide.

Configuring translation settings

To configure translation:

1. Click > Admin > Sites & Settings.

2. In the Sites widget, click the site for which you want to configure translation, or click Global to configure for all sites.

3. Under the CMS tab, expand the Translation cluster.

4. Configure the global translation settings:

   Field	Description
   Available Locales	Select the locales editors can translate content to. This limits the target locales available when submitting content for translation.
   Locale Groups	Create groups of specific locales for faster selection. For example, group "Spanish (Mexico)" and "German (Austria)" if those are commonly used together.
   Default Service Settings	Select the default translation service to use.

5. Configure type-specific settings under Type Settings:

   1. Click Add Type Setting.

   2. Under Types, select the content types editors can send for translation.

   3. Under Completion Action, configure what happens when translation completes:

      Option	Description
      Publish	Publishes the translated asset immediately.
      Draft	Saves the translated asset as a draft.
      Workflow	Submits the translated draft into a workflow. Select the target workflow state in Workflow Return State.

   4. Configure Site Assignment to control which site owns the translated content:

      Option	Description
      Source Content Site	The translated asset is owned by the same site from which it was sent for translation.
      Auto	The translated asset is owned by a site automatically determined based on available locales. Choose Shared (group of sites) or One-Off (specific sites).
      Manual	The translated asset is owned by a specific designated site.
      User Site	The translated asset is owned by the site the editor was in when submitting.

6. Click Save.

Available locales

The Available Locales setting controls which languages content can be translated to. Only locales configured here appear as options when editors send content for translation.

Locale selection modes

Brightspot provides three modes for configuring available locales:

Mode	Description
All	All Java locales are available as translation targets. Use this for maximum flexibility.
Only	Allow list mode. Only the locales you explicitly select are available. Best for organizations with a defined set of target languages.
All Except	Block list mode. All locales are available except those you explicitly exclude. Useful when you want most locales but need to exclude a few.

Locale groups

Locale groups allow editors to quickly select multiple related locales at once.

tip

Configure locale groups for commonly-used combinations to speed up editor workflows. For example, if your team frequently translates to all European languages at once, create a "European Languages" group.

To create a locale group:

1. In the translation settings, click Add Locale Group.
2. Enter a Display Name (e.g., "European Languages").
3. Select the Locales to include in the group.
4. Click Save.

When editors send content for translation, they can select a locale group to automatically include all its locales.

Completion actions

Completion actions determine the state of translated content when it's returned from the translation service:

• Publish is useful for high-confidence machine translations or pre-approved content
• Draft allows editors to review translations before publishing
• Workflow integrates translation into your existing editorial process

You can configure different completion actions for different content types based on your editorial requirements.

Site assignment

Site assignment controls content ownership for translated assets. This is particularly important in multi-site configurations where different sites serve different locales.

The Auto option is recommended for most configurations, as it automatically assigns translated content to the appropriate site based on locale configuration.

Permissions

Translation permissions control which translation features and actions users can access. Configure permissions through Brightspot's Users & Roles system.

Configuring translation permissions

To configure translation permissions for a role:

1. Click > Admin > Users & Roles.
2. Select the role you want to configure.
3. Under Additional Permissions, expand Translation.
4. Configure the Translation Permission setting.

Permission modes

Mode	Description
All	Users with this role have access to all translation features and actions.
Only	Allow list mode. Users can only access the translation features you explicitly select.
All Except	Block list mode. Users can access all translation features except those you explicitly exclude.
None	Users with this role cannot access any translation features.

Available permissions

When using Only or All Except mode, you can select from the following permissions:

Permission	Description
Edit Content Locale	Allows users to change the locale of existing content.
Translate Content	Allows users to send content for translation.
Translation Action - Cancel AWS Translation	Allows users to cancel in-progress Amazon Translate jobs.
Translation Action - Cancel Lingotek Translation	Allows users to cancel in-progress Lingotek translations.
Translation Action - Resolve Translation Errors	Allows users to resolve and retry failed translations.
Translation Action - Update Lingotek Translation	Allows users to manually refresh Lingotek translation status.
Translation Action - View Translation Log	Allows users to view detailed translation log information.

tip

The available permissions depend on which translation services are installed. For example, AWS-specific permissions only appear if the Amazon Translate module is installed.

Service-specific permissions

Translation services can provide additional permissions beyond the core set. These permissions are automatically registered when the service module is installed and appear in the permission selector. See Translation Permission Provider for information on implementing custom permissions.

Localization site groups

For multi-site configurations where different sites serve different locales, you can organize sites into localization groups.

To configure localization site groups:

1. In the translation settings, find Localization Site Groups.
2. Click Add Localization Site Group.
3. Enter a Display Name for the group.
4. Select the Sites to include.
5. Select the Locales this group handles.

Localization site groups help Brightspot automatically route translated content to the appropriate site and streamline the content editing experience by hiding irrelevant URL options.

Translation widget

The Translation widget provides an overview of translation activity across your site. Administrators can add this widget to dashboards for monitoring translation status.

To add the translation dashboard widget:

1. Click > Admin > Dashboards.
2. Select an existing dashboard to edit, or create a new one.
3. Add the Translation widget to the dashboard.
4. Configure widget options:
   • Title — Custom title for the widget
   • Status Filter — Filter by translation status (pending, completed, failed)
   • Locale Filter — Filter by target locale
5. Click Save.

The widget displays a paginated list of recent translations with status, locale, and links to the source and translated content.

Notifications

Brightspot can notify users when translation events occur. Users must subscribe to translation notifications in their profile settings.

Subscribing to translation notifications

To subscribe to translation notifications:

1. In the header, click your username, then click Profile.

2. Under Subscriptions, click Add and select Translation.

3. Configure the subscription:

   Field	Description
   Delivery Methods	How to receive notifications (e.g., CMS Only, Email)
   Topic	Set to Translation

4. Configure the Translations Filter to control which translations trigger notifications:

   Filter	Description
   Translation Service	Filter by service (All Services, or a specific service like Amazon Translate)
   Translation Status	Filter by status (All Statuses, or specific statuses like Success, Failure)
   Translation Creator	Filter by who requested the translation (Any, or Translations I Created)
   Content Filters	Filter by sites and content types

5. Click Save.

tip

You can add multiple filter groups using Add Services & Statuses to create complex notification rules. For example, receive notifications for all failed translations, but only successful translations for specific content types.

Notification events

Notifications are sent when:

• A translation completes successfully
• A translation fails
• A translation is canceled

Notifications appear in the user's notification panel in the Brightspot toolbar.

Next steps

• Send content for translation
• Configure a specific translation service (Amazon Translate, Google Translate, or Lingotek)