# Configuration

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

Source: https://docs.oursprivacy.com/docs/translate/configuration

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

[Open Translations in app](https://app.oursprivacy.com/marketing-center/translations)

***

## 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:

| Position       | Description                   |
| -------------- | ----------------------------- |
| `bottom-right` | Bottom-right corner (default) |
| `bottom-left`  | Bottom-left corner            |
| `top-right`    | Top-right corner              |
| `top-left`     | Top-left corner               |

### Theme

Choose a color scheme:

| Theme   | Description                               |
| ------- | ----------------------------------------- |
| `light` | Light background with dark text (default) |
| `dark`  | Dark 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:

| Variant      | Display                                        | Best For                  |
| ------------ | ---------------------------------------------- | ------------------------- |
| **Compact**  | Flag + language code (e.g., 🇺🇸 EN)           | Most sites (default)      |
| **Extended** | Flag + full language name (e.g., 🇺🇸 English) | When clarity is important |
| **Minimal**  | Flag only (e.g., 🇺🇸)                         | Space-constrained designs |

***

## Modal Variants

Choose how the language selection modal appears. The **Standard modal** and **Grid modal** views in [How the options combine](#how-the-options-combine) show the first two opened on a page.

| Variant      | Display                         | Best For                 |
| ------------ | ------------------------------- | ------------------------ |
| **Standard** | Vertical list with search       | Many languages (default) |
| **Grid**     | Grid layout of language options | Visual selection         |
| **Dropdown** | Compact dropdown list           | Minimal 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.

**Translation widget configuration examples**

* **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.

  ![A light clinic page with a small circular translate button in the bottom-right corner showing a translate icon.](https://docs.oursprivacy.com/img/translate/translate-img-9.jpg)

* **Extended, dark**: The extended variant labels the button in words rather than a code, and the dark theme keeps it legible on a dark page. Moved to bottom-left, where this layout has room.

  ![A dark navy page with a dark pill-shaped button in the bottom-left corner reading Translate beside a translate icon.](https://docs.oursprivacy.com/img/translate/translate-img-10.jpg)

* **Standard modal**: The standard modal, opened. A search box above a vertical list is the right shape when the visitor may be looking for one language out of many.

  ![The Choose Language modal open over the page in its standard list layout, with a search box above English, Español, Français and Deutsch each with a flag, and a footer reading 75 languages available and Preference saved locally.](https://docs.oursprivacy.com/img/translate/translate-img-11.jpg)

* **Grid modal**: The grid modal shows more options at once and leads with the flags, which suits a short offered-languages list.

  ![The Choose Language modal open in its grid layout, showing language options as flag tiles in three columns, with a footer reading 75 languages available and Grid view.](https://docs.oursprivacy.com/img/translate/translate-img-12.jpg)

* **Minimal, top-right**: The minimal variant is the smallest of the three: a translate icon before a language is picked, then that language’s flag alone. Anchored top-right here so it reads as part of the header. Because it carries no label, pair it with a line of body copy pointing at it, as this page does.

  ![A cream page set in a serif typeface with a small circular translate button in the top-right corner beside the header.](https://docs.oursprivacy.com/img/translate/translate-img-13.jpg)

***

## Language Selection

### Offered Languages

By default, the translation widget offers all [75 supported languages](https://docs.oursprivacy.com/docs/translate/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 every [supported language](https://docs.oursprivacy.com/docs/translate/supported-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 **Grid modal** view in [How the options combine](#how-the-options-combine) shows this layout opened on a page.

***

## 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

* [Protect brand names and terms](https://docs.oursprivacy.com/docs/translate/no-translate-terms) from being translated
* [Exclude specific content](https://docs.oursprivacy.com/docs/translate/excluding-content) from translation
* [View all supported languages](https://docs.oursprivacy.com/docs/translate/supported-languages)
* [Track usage with analytics](https://docs.oursprivacy.com/docs/translate/analytics)
