BoldDesk Web Widget Text Customization Guide
BoldDesk allows administrators to customize Web Widget text labels and descriptions for Tickets (Contact Form) and the Help Center (Knowledge Base) using Advanced Customization (Custom JS). This ensures consistent terminology across your Tickets, Help Center, and customer-facing UI.
Use Cases
Use Web Widget customization in BoldDesk when you need to:
- Align Ticket submission terminology (e.g., “Send a Ticket” instead of “Contact Form”)
- Improve clarity in the Ticket creation experience
- Match widget language with your Help Center content structure
- Support multilingual customer portals using custom scripts
- Maintain consistent wording across Admin Settings, Tickets, and Web Widget UI
- This customization applies only to the Web Widget
- It is not supported in the Live Chat widget
- Text changes are static and script-based
- You must define language-specific content manually
Customize Contact Form Text
Navigation Path
Go to:
Admin → Web Widgets & AI Agent → Add/Edit Web Widget → Advanced Customization → Custom JS
Steps
- Navigate to Admin Setting and click Web Widgets & AI Agent
- Add/Edit Web Widget
- Select Advanced Customization
- Open the Custom JS
- Add the script below
- Click Save to apply changes
Custom JS code
Use this script to rename the Contact Form and update its description:
const aiContainers = document.querySelectorAll(".ai-wrapper-container");
if (aiContainers.length > 0) {
const index = aiContainers.length - 1;
const targetElement = aiContainers[index].querySelector(".description-container");
if (targetElement) {
targetElement.querySelector(".text").innerHTML = 'Send a Ticket';
targetElement.querySelector(".desc").innerHTML = 'Submit your queries, and we will get back to you.';
targetElement.style.overflowWrap = 'break-word';
}
}
Before customization
After customization
Customize Knowledge Base Text (Help Center Section)
BoldDesk enables customization of the Help Center label and description inside the Web Widget to match your Knowledge Base structure.
- Custom text does not automatically change based on the user’s language preference.
- Content must be explicitly defined per language in the script.
Example: Multi-Language Customization (German)
The following script updates the Knowledge Base label and description:
const aiContainers = document.querySelectorAll(".ai-wrapper-container");
//Knowledge Base (German)
index = aiContainers.length - 2;
if (index >= 0) {
let el = aiContainers[index].querySelector(".description-container");
if (el) {
el.querySelector(".text").textContent = "Hilfe-Center";
el.querySelector(".desc").textContent = "Durchsuchen Sie Anleitungen und finden Sie schnell Antworten.";
}
}
Substitute the sample text with translated versions to accommodate your preferred languages, including French and Spanish. For further information, please refer to the List of Languages Supported in BoldDesk.
Before and After Customization
Before Customization
After Customization
Customize Contact Form Text
BoldDesk allows you to customize the Contact Form label and description in your desired language in the Web Widget using Custom JavaScript (JS). This is useful for localization and branding purposes.
Example: Multi-Language Customization (German)
The following script updates the Contact Form label and description:
const aiContainers = document.querySelectorAll(".ai-wrapper-container");
//Contact Form (German)
let index = aiContainers.length - 1;
if (index >= 0) {
let el = aiContainers[index].querySelector(".description-container");
if (el) {
el.querySelector(".text").textContent = "Ticket senden";
el.querySelector(".desc").textContent = "Senden Sie Ihre Anfragen, wir melden uns bei Ihnen.";
}
}
Before and After Customization
Before Customization
After Customization
Frequently Asked Questions
-
Can I customize Web Widget text without using Custom JS?
No. In BoldDesk, Web Widget label customization requires Custom JS under Advanced Customization. -
Does BoldDesk automatically translate Web Widget content based on user language?
No. BoldDesk does not automatically localize widget text. You must manually define each language inside the Custom JS. -
Will these changes affect Ticket fields or Help Center content in Admin Settings?
No. Changes only modify Web Widget UI text and do not impact Tickets, fields, or Help Center articles. -
Is there a built-in UI option in BoldDesk to rename “Contact Form” globally?
No. BoldDesk currently does not provide a native UI setting to rename the Contact Form globally—you must use Custom JS.
