> ## Documentation Index
> Fetch the complete documentation index at: https://bookingspotapp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Translate the booking widget

> Use automatic browser languages, edit any widget message, and understand fallbacks and custom translations.

Open **Widget → Text & languages**. Widget translations are separate from email translations. Every business has one default widget, so saved wording is shared by Shopify blocks, hosted pages and the direct calendar link.

## Choose language behavior

| Control | What it does |
| - | - |
| **Use the customer’s language automatically** | Uses the storefront language when supplied; otherwise checks supported browser language preferences. Regional variants use the corresponding base language. |
| **Default language** | Used when automatic language selection is off or a supported preference is unavailable. |
| **Edit copy for** | **Default copy** edits your general wording; choose a language for a translation override. English uses Default copy. |
| **Preview language** | Changes the sample only. It does not set the customer's language. |

Built-in widget copy covers **English, Spanish, French, German, Italian, Dutch, Japanese, Polish, Portuguese, Korean, Bulgarian, Czech, Danish, Finnish, Hungarian, Indonesian, Norwegian and Swedish**. French Canadian uses French; Brazilian Portuguese uses Portuguese. Norwegian Bokmål and Nynorsk use Norwegian.

## Translate your own wording

1. Find the message using **Search widget text**, or choose a **Text section**.
2. With **Edit copy for → Default copy**, enter your usual wording.
3. Select a language, such as **French**, in **Edit copy for**. The built-in translation appears and the preview switches to that language. Enter your translated wording.
4. Keep any variables listed under the field exactly as shown, including both pairs of braces. Use only that field's listed variables.
5. Check **Preview language**, then click **Save design**. Repeat for every language where you want custom wording.

![Widget language editor with French selected, search and translation controls circled.](https://mintcdn.com/booking-spot/fnCSF9SSH_FTDtd8/assets/screenshots/widget-text-languages.png?fit=max\&auto=format\&n=fnCSF9SSH_FTDtd8\&q=85\&s=b6874a6fd99f72d440dcd4c3c745f11d)

Search for a message, choose a translation, then review the actual widget preview.

A language-specific override takes priority over your default wording. Your authored default copy stays as written unless you add a translation. Built-in translations fill fields without custom wording. **Use default** removes the selected field's override; if a general override still exists, it continues to apply. To restore stock wording everywhere for a field, reset both its general override and any language overrides.

This does not run machine translation. Service names, professional names, question labels, choice text and waivers keep the words entered in Team or Services. Emails have English and Spanish stock copy and their own manual language overrides in [Workflows](https://bookingspotapp.com/docs/communications/copy-and-language.md).

## Edit or hide text

The text sections cover headings, steps and buttons, calendar and availability, customer details and policy, waitlist, and confirmations or messages. Search also finds duration labels, status text and validation errors. See the [complete widget text reference](https://bookingspotapp.com/docs/booking-pages/text-reference.md) for every field.

Optional introductions, hint lines, timezone notes and duration details can be cleared to hide them. Free requires widget attribution. Starter and Pro can hide it in **Widget → Appearance**, or leave the footer blank. [See attribution settings](https://bookingspotapp.com/docs/booking-pages/widget.md#booking-spot-attribution). Required labels and actions need non-empty wording. Editing the notice text does not change booking rules: change the notice period in **Settings → Business and policies**.

For a useful test, preview an available booking, approval request and a day with no times. Check a narrow screen too. Switching editor tabs keeps edits on this page; save before navigating away.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.