Customizing the labels in BMC Helix Digital Workplace

As an administrator, you can customize the labels for appointments, catalog sections, global search, My Activity, and My Stuff.

For example, you can change the title of the Contact IT button to Contact support. You can also customize application labels for specific locales. Label customization helps accommodate the application to specific regions and provides a location-wise user experience.

Scenario

Scenario of customizing labels

Allen is an administrator of BMC Helix Digital Workplace at Apex Global in France. He is customizing the user interface for BMC Helix Digital Workplace to suit the company's French audience.

Allen wants to display localized labels for the My Stuff and Catalog pages. He logs in to the Admin console and navigates to Configuration> Label Customizations.

Allen enters his preferred localized text in the appropriate fields and saves the configuration. After he saves the configuration in the Admin console, the users who log in to their end-user console can see these custom localized labels.

Britney, an end user, has selected a French browser locale. Therefore, when she logs in to the end-user console, she sees a custom localized label for the My Stuff page: Mes affairs.

Before you begin

For the list of the supported languages and locales in BMC Helix Digital Workplace, see Supported-languages-and-locales.

To customize application labels

Log in to the Admin console.
Select Configuration > Label Customizations.
On the Label Customizations page, select the locale for which you want to change the default text.
Important
Configure the value for the set of labels for the default locale, English (US), first, and then configure custom localized labels for the other desired supported locales. If your browser uses a locale that BMC Helix Digital Workplace does not support, the labels set for English (US) are displayed.

Expand the intended section and enter the custom text in the corresponding fields to change the default labels.
If you do not enter any custom text, the default labels are displayed to end users.
See the following list of application labels that you can customize:

Section	Label field name
Application views Appointments, support contacts	Make an appointment modal title/button This capability is available only with the BMC Helix Digital Workplace Advanced license. Example of the Admin console configuration. Result in the end-user console.
	Make an appointment description hint This capability is available only with the BMC Helix Digital Workplace Advanced license. Example of the Admin console configuration. Result in the end-user console.
	Contact IT/general help modal title/button
Catalog, requests, assets Default catalog page, cart, checkout, My stuff page	Default catalog page
	My Stuff page This capability is available only with the BMC Helix Digital Workplace Advanced license. Example of the Admin console configuration. Result in the end-user console.
	Add to cart button This capability is available with only the BMC Helix Digital Workplace Advanced license.
	Item profile: request now button
	Checkout: submit request button
	Checkout: save (to cart) and close button This capability is available only with the BMC Helix Digital Workplace Advanced license.
Search, categories Search bar, search results, catalog categories menu	Default search field hint Example of the Admin console configuration. Result in the end-user console.
	Catalog categories menu
	Search results: catalog items
	Search results: knowledge articles
Events My Activity page name, events component labels	Default My Activity page Example of the Admin console configuration. Result in the end-user console.
	Active events
	Past events
	Filtered active events
	Filtered past events

See the image displaying the Label Customizations page showing the default placeholder values.

(Optional) Customize the text to be displayed in the global search field.
You can add variables, and end users will see the variable values. You can add more than one variable. Add your variables within curly braces. Use the following variables based on your choice:
{first name}, {last name}, {full name}, and {user id}
For example, enter the text in the field Default search field hint: Hello {first name}, what are you looking for?
The end user, Bob, sees the search hint text: Hello Bob, what are you looking for?

Important
This capability is only supported for the Default search field.
(Optional) To revert from custom text back to the default placeholder text, click Reset for the required field.
The following dialog box displays the reset options:

Click one of the following options:
- Cancel—Cancels the operation.
- Reset English(US) only—The field restores the default value only for the selected locale.
- Reset all languages—The field restores the default values for all the translations for the configured locales.
(Optional) If you want to restore the default values for all fields displayed on the page for the selected locale, click Reset all to default.
This option resets all the fields only for the selected locale and displays default placeholder values.
Click Save and close the window.
The changes are applied to the end-user console only after you save the configuration.

Customizing the labels in BMC Helix Digital Workplace

Scenario

Before you begin

On this page