Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Edit a UI action

Edit a UI action

You can edit an existing UI action or create a new one.

Before you begin

Role required: ui_action_admin or admin

About this task

You can add UI actions to tables and database views that are in the same scope as the UI action and tables that allow UI actions from another application scope to run on them.

Procedure

  1. Navigate to System Definition > UI Actions.
  2. Click New or open an existing record.
  3. Define the UI action by completing the fields.
    You may need to configure the form to see all the fields.
    Table 1. UI action fields
    Field Description
    Name Defines the text that appears on the button, link, or context menu item.
    Table Defines the table on which the UI action is available. By default, the UI action also appears on tables that extend the selected table (for example, Task actions appear on the Incident table).

    Select Global to make the action available on all tables.

    Order Defines the order in which the UI action appears. The order applies to buttons from left to right and to menu actions from top to bottom.
    Action name Defines a name to use when referencing the UI action in scripts.
    Active Enables the UI action when selected. To disable a UI action, clear the check box.
    Show insert Shows a button on new records that have not been inserted.
    Show update Shows a button on existing records.
    Client The UI action executes its script in the user's browser, not on the server. When enabled, the Onclick field appears above the Condition field.
    List v2 Compatible Indicates that the UI action is compatible with v2 lists. This field must be enabled to display the UI action in a v2 list, but only if the List v3 Compatible field is enabled as well. If the List v3 Compatible field is not enabled, the UI action displays in v2 lists regardless of the List v2 Compatible field state.
    List v3 Compatible Indicates that the UI action is compatible with v3 lists. This field must be enabled to display the UI action in a v3 list.
    Form button Puts a button on a form.
    Form context menu Puts an item in a form context menu (right-click the form header).
    Form link Puts a link in the Related Links section of a form.
    List banner button Puts a button in the banner of a list.
    List bottom button Puts a button at the bottom of a list.
    List context menu Puts an item in a list field context menu (right-click a cell in a list).
    List choice Puts an item in the action choice list at the bottom of a list.
    List link Puts a link in the Related Links section at the bottom of a list.
    Overrides Specifies a UI action that this UI action overrides.
    Comments Provides descriptive content regarding this UI action.
    Hint Defines the text that appears when a user points to the UI action control.
    Onclick The name of the JavaScript function to run when the UI action is executed. The function is defined in the Script field.
    Condition Defines the conditions that restrict when a UI action appears.
    Script Defines the script to run when the UI action is executed.
    Related lists on the form view:
    UI Action Visibility Specifies other views of the form that the UI action applies to.
    Versions Shows all versions of the UI action. Use this list to compare versions or to revert to a previous version.
  4. Click Submit or Update.
    Note: If the UI action is enabled to run on the client side, wrap it in a function. Otherwise, the contents of the Script field runs when the page loads.