CDPGuidesSupport

Configuration

Customize the translation widget with themes, brand colors, positioning, and display variants.

Configuration

Customize the Translation Widget to match your brand and user experience requirements.

Open Translations in app

Appearance Options

Configure these options in the Ours Privacy dashboard under Translations when creating or editing your widget.

Position

Control where the floating button appears on the page:

PositionDescription
bottom-rightBottom-right corner (default)
bottom-leftBottom-left corner
top-rightTop-right corner
top-leftTop-left corner

Theme

Choose a color scheme:

ThemeDescription
lightLight background with dark text (default)
darkDark background with light text

Brand Color

Set a custom accent color for the button and highlights. Use any valid hex color:

  • #2C73D7 (default blue)
  • #0057FF (brand blue)
  • #FF9900 (orange)
  • Any hex color that matches your brand

Widget Variants

Choose how the floating button displays:

VariantDisplayBest For
CompactFlag + language code (e.g., 🇺🇸 EN)Most sites (default)
ExtendedFlag + full language name (e.g., 🇺🇸 English)When clarity is important
MinimalFlag only (e.g., 🇺🇸)Space-constrained designs

Choose how the language selection modal appears:

The Choose Language modal in its standard list layout, with a search box above a vertical list of languages showing English, Español, Français and Deutsch each with its flag and English name, and a footer reading 75 languages available and Preference saved locally
VariantDisplayBest For
StandardVertical list with searchMany languages (default)
GridGrid layout of language optionsVisual selection
DropdownCompact dropdown listMinimal UI footprint

How the options combine

Each view below is the same widget on the same page with a different combination of position, theme, brand color, and variant. All of them are dashboard settings — no CSS is involved.

A light clinic page with a small circular translate button in the bottom-right corner showing a translate icon.

Compact, light. The default: compact variant, light theme, bottom-right. Before a visitor picks a language the button shows a translate icon; once they do, it shows their flag and language code.


Language Selection

Offered Languages

By default, the translation widget offers all 75 supported languages to your visitors. You can curate this list to show only the languages relevant to your audience.

To customize the language list:

  1. Go to Translations in the dashboard
  2. Open a translation widget
  3. Scroll to Languages Offered
  4. Click the dropdown to select specific languages

When languages are selected, only those appear in the widget. Leave the list empty to offer all 75 languages.

Considerations

  • Your audience: Which languages do your visitors speak?
  • Content relevance: Is your content applicable to those regions?
  • Support capabilities: Can you support visitors in those languages?

Priority Languages

The widget automatically prioritizes the top 5 most common languages (English, Spanish, French, German, Chinese) at the top of the list, with remaining languages sorted alphabetically.


Example Configurations

Example 1: Multiple Languages

Position: bottom-right
Theme: light
Brand Color: #0057FF
Widget Variant: compact
Modal Variant: standard
Languages: en, es, fr, de, zh, ar, pt, ja, ko, vi

Example 2: Minimal Setup

Position: bottom-left
Theme: dark
Brand Color: #333333
Widget Variant: minimal
Modal Variant: dropdown
Languages: en, es, fr

Example 3: Grid Layout

Position: bottom-right
Theme: light
Brand Color: #2563eb
Widget Variant: extended
Modal Variant: grid
Languages: en, es, zh, vi, tl, ko, ar, ru
The Choose Language modal in its grid layout, with a search box above a three-column grid of language cards for English, Español, Français, Deutsch, Chinese (Simplified) and Afrikaans, each card showing a flag with the language name and its English name, and a footer reading 75 languages available and Grid view

Z-Index Handling

The widget automatically detects the highest z-index on your page and positions itself above other elements. This ensures the widget remains accessible even on pages with complex layering (modals, sticky headers, etc.).


Next Steps

How is this guide?

On this page