---
schema_version: "1"
id: d3db83bc375a83b92231b5feae0c271169255de0e573267f927c72206eb45400
title: Customize Omniscript Error Messages (Managed Package)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_customize_omniscript_error_messages.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_customize_omniscript_error_messages.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 18cd44df77df4c929b4024e228bf442a46c1689374be931fb45bc65c5ce977aa
description: For the managed package runtime, the error message handler enables you to replace default error messages from remote apex calls with more user-friendly error messages when errors occur in Omniscript. The Error Messages handler property is available in File elements, Image elements, all Action elements, Omniscript Script Configuration, and Setup.
products:
  - Omnistudio
release: "264"
---
# Customize Omniscript Error Messages (Managed Package)

For the managed package runtime, the error message handler enables you to replace default error messages from remote apex calls with more user-friendly error messages when errors occur in Omniscript. The Error Messages handler property is available in File elements, Image elements, all Action elements, Omniscript Script Configuration, and Setup.

![Managed Package app icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/resources-global/_corporate/images/managedpackageicon.png) This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see [Omnistudio Help](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_standard.htm&language=en_US).

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_note.png)

Note

Error Messages set in the Setup or Script Configuration properties apply to any matching error returned by an element, while Error Messages set in an Action’s properties only render for that Action.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
      <colgroup>
        <col>
        <col>
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d270211e57">
            <p style="margin-bottom:0;">Error Message Type</p>
          </th>
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d270211e63">
            <p style="margin-bottom:0;">Description</p>
          </th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="Error Message Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d270211e57 ">
            <p style="margin-bottom:0;">
              <strong class="uicontrol"> Default Error Message</strong>
            </p>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d270211e63 ">
            <p style="margin-bottom:0;">A default message that returns when no Custom Error Messages are matched or
              defined. The Default Error Message property is not available in<span> Script Configuration or</span> Setup.</p>
          </td>

        </tr>
        <tr class="">
          <td data-label="Error Message Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d270211e57 ">
            <p style="margin-bottom:0;">
              <strong class="uicontrol"> Custom Error Messages</strong>
            </p>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d270211e63 ">
            <p>Messages that are returned based on the defined path and value. Custom Error
              Messages are configured using the following fields:</p>
            <ul>
              <li>
                <p><strong class="uicontrol"> Path</strong>: A merge field path that locates the
                  original default value inside an error object.</p>
              </li>

              <li>
                <p><strong class="uicontrol"> Value</strong>: The original error message, including
                  spaces, that will be replaced by the text defined in the Message
                  field. This value must match the original error exactly.</p>
              </li>

              <li>
                <p><strong class="uicontrol"> Message</strong>: The custom message that will replace
                  the error text defined in the Value field.</p>
              </li>

            </ul>
          </td>

        </tr>
      </tbody>
    </table>

- **[Set the Default Error Message on an Omniscript Element (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_set_the_default_error_message_on_an_omniscript_element.htm&release=264.0.0&type=5)**  
    For the managed package runtime, replace a Default Error Message with a user-friendly error message when a remote apex call error occurs in your Omniscript. A default message returns when no custom error messages are matched or defined. Update the default error messages for Image, Action, and File elements.
- **[Set a Custom Error Message That Returns as an Object (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_set_a_custom_error_message_that_returns_as_an_object.htm&release=264.0.0&type=5)**  
    For the managed package runtime, set a Custom Error Message for an error that returns as an object. A Custom Error Message returns based on a defined path and value. Set custom error messages for File elements, Image elements, all Action elements, Omniscript Script Configuration, and Setup.
- **[Set a Custom Error Message That Returns as a String (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_set_a_custom_error_message_that_returns_as_a_string.htm&release=264.0.0&type=5)**  
    For the managed package runtime, set a Custom Error Message for an error that returns as a string. A Custom Error Message returns based on a defined path and value. Set custom error messages for File elements, Image elements, all Action elements, Omniscript Script Configuration, and Setup.