Skip to content
Artifact configurations › Configure the Localization Framework › Localization Framework › Translation and localization › Configure core features › Administer the ServiceNow AI Platform
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a UI action for the custom artifact

Create a UI action to request translations for the custom artifact.

Before you begin

Role required: localization_admin

Procedure

  1. Navigate to the custom artifact table.

    Find the table using its table name. For example, [sys_cs_topic] is the table name for Virtual Agent topics.

  2. Click the hamburger icon (

Image omitted: hamburger-icon.png
Hamburger icon\) at any of the columns and navigate to **Configure** **UI Actions**.

  1. Click New.

  2. In the UI Actions form, fill in the fields.

FieldDescription
NameName for the UI action.For example, Request Translations.
ClientOption to execute the script in the user's browser. When enabled, the Onclick field appears above the Condition field.
ConditionCondition to decide when to show this UI action.
OnclickProvide the JavaScript function name as: 
renderLanguagePickerModal();
Script

Option to execute the script to run the request translations function. The script varies for Form button and List choice.

  • Form Button

    ``` function renderLanguagePickerModal() {

    var dlg = new GlideModal("sn_lf_language_picker"); dlg.setTitle(getMessage("Request Translations")); dlg.setPreference("sys_id", g_form.getUniqueValue()); dlg.setPreference("artifact_config_internal_name", "catalog_item"); dlg.setPreference("request_type", "form"); dlg.setPreference("focusTrap", true); dlg.render(); } ```

  • List choice

    function renderLanguagePickerModal() { var sys_ids = g_list.getChecked(); if (!sys_ids || sys_ids.length == 0) return; var dlg = new GlideModal("sn_lf_language_picker"); dlg.setTitle(getMessage("Request Translations")); dlg.setPreference("sys_id", sys_ids); dlg.setPreference("artifact_config_internal_name", "catalog_item"); dlg.setPreference("request_type", "list"); dlg.setPreference("focusTrap", true); dlg.render(); }

Form buttonOption to enable the UI action as a form button.
List choiceOption to enable the UI action in the choice list.
**Note:** Configure the form to see all the fields. For more information, see [Create a UI action](../t_EditingAUIAction.md).
  1. Click Submit.

Parent Topic:Artifact configurations