How to Embed BoldDesk Web Widgets in Multiple Languages Using Language Codes
BoldDesk Web Widgets can be rendered in a specific language by adding a language code into the widget embed script URL. This article explains how to render BoldDesk Web Widgets in a specific language by configuring the widget embed script URL. By manually adding a supported language code, you can control the widget’s displayed language across different pages without relying on browser detection or admin‑side settings.
When to Use this
- Use this approach when:
- A website needs the same widget to load in different languages.
- You want to control the widget language directly from the embed script, rather than relying on browser language detection (if any).
Configuration Availability
- No admin toggle exists in BoldDesk to set the widget language for embedding.
- No configuration path exists to select a language inside the widget settings for this behavior.
- Language selection is controlled by manually editing the embed script URL.
Get the Widget Embed Code
-
Go to Admin → Web Widgets & AI Agent.
-
Locate the target widget.
-
Select the More options (⋮) icon for the widget.
-
Select Embed code.
-
Copy the embed script.
Add the Language Code to the Embed Script URL
Edit the copied embed code and insert the required language code into the URL path.
URL pattern
<script src="https://www.example.com/{language-code}/widget/{widget-id}" defer async></script>
Examples
French (fr)
<script src="https://www.example.com/fr/widget/3bda8530-486e-4659-8eff-460dfb819682" defer async></script>
German (de)
<script src="https://www.example.com/de/widget/3bda8530-486e-4659-8eff-460dfb819682" defer async></script>
Deploy the Widget on Your Website
Add the modified <script> tag to the website page where the widget should appear. The widget renders using the language associated with the inserted language code.
Supported Languages and Language Codes
Use the BoldDesk supported language list to find valid codes. Explore List of Languages Supported in BoldDesk to check supported languages and their codes.
Frequently Asked Questions
1. Where do I add the language code in the embed script?
Insert the language code directly into the script src URL path, immediately after the domain (for example: /fr/widget/...).
2. Do I need to change anything in BoldDesk Admin settings to set the widget language?
No. The widget language for this method is controlled by editing the embed URL.
3. Can I use different languages for the same widget on different pages?
Yes. Use the same widget ID but embed different script URLs (each with its own language code) on different pages.
4. What happens if I use an unsupported language code?
The behavior depends on BoldDesk’s handling for invalid codes. Use the supported language list to avoid unsupported values.
5. Is the widget ID affected when changing the language code?
No. Only the language segment changes. The widget ID remains the same.
6. Do I need to update the embed code every time I want to switch languages?
Yes. This method requires changing the language code in the script URL.
