---
schema_version: "1"
id: 2cc333df9b5502e4895c3a05fb9dfd4f4e2543c27c0ca8594fbe7c2bb0dca301
title: Omniscripts Multi-Select Element (Managed Package)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_omniscripts_multi_select_element.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_omniscripts_multi_select_element.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: fb3dd1d548e8e86b7fbb94c3e845f9de57d4fe46b29d29827d579a4b5f0b073b
description: For the managed package runtime, enable users to select from multiple items by adding the Multi-select element to your Omniscript. Display options vertically, horizontally, or as an image.
products:
  - Omnistudio
release: "264"
---
# Omniscripts Multi-Select Element (Managed Package)

For the managed package runtime, enable users to select from multiple items by adding the Multi-select element to your Omniscript. Display options vertically, horizontally, or as an image.

![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).

1. Drag a **Multi-select** element from the Build panel onto the canvas.
2. In the Properties panel, give the element a name in the **Name** field.
3. In **Field Label**, enter a label visible to the user.
4. (Optional) In **Display Mode**, select how to display the radio buttons. These options are available:
    
    - **Horizontal**: (Default) Display radio buttons next to each other.
    - **Vertical**: Display radio buttons stacked.
    - **Image**: Display each radio button as an image.
        
        Read-only Multi-Select element images render in grayscale. To restore color for these images, see [Restore Color for Read-Only Multi-Select Element Images (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_omniscripts_multi_select_images_no_grayscale.htm&release=264.0.0&type=5 "For the managed package runtime, read-only Multi-Select element images render in grayscale. To restore color for these images, create a .css file, save it as a static resource, then reference it in the Custom Lightning Stylesheet File Name property in Omniscript Setup.").
5. (Optional) If you select **Image** in **Display Mode**, the following are additional properties you can configure:
    
    - **Width**: Sets the image width.
    - **Height**: Sets the image height.
    - **Image Count In Row**: Sets how many images per row to display.
    - **Enable Caption**: Displays a caption below the image.
6. In **Option Source**, select where the list of options come from. Select from one of the following:
    
    - **Manual**: (Default) Manually enter value/label pairs. Available when **Display Mode** isn’t **Image**.
    - **Custom**: Enter the Apex class and method that returns the options. Use the format `ClassName.method`. See [Populating Picklist Values From Apex (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_populating_picklist_values_from_apex.htm&release=264.0.0&type=5 "For the managed package runtime, you can populate Select, Multi-select, and Radio elements from an Apex class that implements Callable and Vlocity Open Interface. The values for the element are obtained during the Omniscript's activation.").
    - **SObject**: Retrieves the picklist values from the Salesforce object and field. Use the format `ObjectAPIName.FieldAPIName`.
    - **Image**: When Image is selected as Display Mode, manually enter value/label pairs and upload images to display. If no image is uploaded, the label displays in the image box.
7. If you select **Manual** or **Image** as an **Option Source**, for each option follow these steps:
    
    1. Click **\+ Add New Option**.
    2. Enter the **Value** and visible **Label**.
    3. If your option is an image, select an image available from the **Choose existing image** dropdown. Or upload an image from your computer from the **Or upload new image** section.
    4. (Optional) Check **Use as Default** to select the option by default.
8. If you select **Custom** as an **Option Source**, in the **Source**, enter the name of a method to call on a class in the format `class.method`.
9. If you select **SObject** as an **Option Source**, in the **Source**, enter the name of a field on an object in the format `SObject.field`.
10. (Optional) To display options based on the selection of another value, configure **Controlling Field Type** by following these steps:
    
    1. To define the source of the controlling field:
        
        - To retrieve picklist options from an Apex class, select **Custom**.
        - To retrieve dependent picklist values from a Salesforce object, select **SObject**.
    2. In **Controlling Field Source**, enter an Apex class.
    3. In **Controlling Field Element**, enter an Omniscript element name.
11. (Optional) For additional properties, see [Common Omniscript Element Properties Definitions (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_common_omniscript_element_properties_definitions.htm&release=264.0.0&type=5 "For the managed package runtime, each element also includes an extensible Property set that's specific to the type of element. Use the Properties pane on the Designer to edit these properties. Some common element properties aren’t available in certain elements.").

- **[Restore Color for Read-Only Multi-Select Element Images (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_omniscripts_multi_select_images_no_grayscale.htm&release=264.0.0&type=5)**  
    For the managed package runtime, read-only Multi-Select element images render in grayscale. To restore color for these images, create a .css file, save it as a static resource, then reference it in the Custom Lightning Stylesheet File Name property in Omniscript Setup.
- **[Multi-Select Properties (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_multi_select_properties.htm&release=264.0.0&type=5)**  
    For the managed package runtime, Multi-Select properties are configurable from the Properties panel when you select a Multi-Select element. With the Multi-Select element, enable users to select one or more items from one or more options in your Omniscript.