Create a UI action for the custom artifact

task australia Updated Sep 10, 2026 1 min read create-ui-action-artifact.md
Raw file servicenow.com

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 ([Omitted image "hamburger-icon.png"] Alt text: Hamburger icon) at any of the columns and navigate to Configure UI Actions.

  3. Click New.

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

Field

Description

Name

Name for the UI action.For example, Request Translations.

Client

Option to execute the script in the user's browser. When enabled, the Onclick field appears above the Condition field.

Condition

Condition to decide when to show this UI action.

Onclick

Provide the JavaScript function name as:``` renderLanguagePickerModal();

Text
</td></tr><tr><td>
Script
</td><td>
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();}    ```
</td></tr><tr><td>
Form button
</td><td>
Option to enable the UI action as a form button.
</td></tr><tr><td>
List choice
</td><td>
Option to enable the UI action in the choice list.
</td></tr></tbody></table>    **Note:** Configure the form to see all the fields. For more information, see [Create a UI action](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/t_EditingAUIAction.md).
5.  Click **Submit**.

**Parent Topic:**[Artifact configurations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/localization-framework/framework-configuration.md)
Search documentation
Search document titles and file paths on the australia branch