Customizing the labels in BMC Helix Digital Workplace

Scenario

Before you begin

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

(Version 23.3.03 and later) To customize application labels

1. Log in to the Admin console.
2. Select Configuration > Label Customizations.

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

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

   

5. (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.

6. (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.

7. (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.
8. Click Save and close the window.
   The changes are applied to the end-user console only after you save the configuration.

(Version 23.3.02 and earlier) To customize application labels

For versions 23.3.02 and earlier, see the following procedures to customize application labels:

(Version 23.3.02 and earlier) To change the appointment description

1. Log in to the Admin console.
2. Select Configuration > Label Customizations.
3. Click the Appointments tab.
4. In the Description/Instructions locale field, select the locale for which you want to change the default text.
5. In the Description/Instructions field, enter the instructions for your users.
6. Click Save.

Following is an example of updated instructions in the Description field:

(Version 23.3.02 and earlier) To change a catalog section label

1. Log in to the Admin console.
2. Select Configuration > Label Customizations.
3. Click the Catalog tab.
4. From the Select locale list, select the locale for which you want to change the labels.
5. If you have a BMC Helix Digital Workplace Advanced license, to change the Appointment label, enter a new name in the Appointment field.
6. To change the Contact IT label, enter a new name in the Contact IT button field.
7. To change the Browse Categories label, enter a new name in the Category name field.
8. Click Save.

Following is an example of the customized Appointment label:

(Version 23.3.02 and earlier) To change the global search labels

1. Log in to the Admin console.
2. Select Configuration > Label Customizations.
3. Click the Global search tab.
4. From the Select locale list, select the locale for which you want to apply the changes.

5. To change the default text displayed for the global search, in the Placeholder field, enter new text.

   Important

   You can also add name variables in the Placeholder field. End users can see the variable values. Add the name variable within curly braces. You can use the following variables: {first name}, {last name}, {full name}, and {user id}. You can add more than one variable.

6. To change the names of the global search filters, in the Results filter tabs section, enter new values for the following fields:
   • Filter name for Catalog items
   • Filter name for Knowledge articles
7. Click Save.

 Following is an example of the customized text in the global search field:

(Version 23.3.02 and earlier) To change the My Activity section labels

1. Log in to the Admin console.
2. Select Configuration > Label Customizations.
3. Click the My Activity tab.
4. From the Select locale list, select the locale for which you want to change the labels.
5. To change the My Activity label, enter a new name in the My Activity Tab Name field.
6. To change the Active events label, enter a new name in the Active events field.
7. To change the Past events label, enter a new name in the Past events field.
8. To change the Filtered active events label, enter a new name in the Filtered active events field.
9. To change the Filtered past events label, enter a new name in the Filtered past events field.
10. Click Save.

Following is an example of a customized My Activity label:

(Version 23.3.02 and earlier) To change the label of the My Stuff tab

This option only applies to aBMC Helix Digital Workplace Advanced license.

1. Log in to the Admin console.
2. Select Configuration > Label Customizations.
3. Click the My Stuff tab.
4. From the My Stuff Tab Name locale field, select the locale for which you want to change the label.
5. In the My Stuff Tab Name field, enter a new name.
6. Click Save.

Following is an example of the My Stuff label: