---
schema_version: "1"
id: 9957b845f8e1ecf9b6ce7ad4f54b8345c564a34802e3cbf0d7736c366358efde
title: Omniscripts Multi-Select Element
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_16739.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_omniscripts_multi_select_element_16739.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: f80afc7049c2fca95438f8a8929367f254968f195307295d3fc6f799ec83860d
description: Enable users to select from multiple items by adding the Multi-select element to your Omniscript. Display options vertically, horizontally, or as an image. Read-only Multi-Select images show in grayscale, but you can use a custom CSS to them in color.
products:
  - Omnistudio
release: "264"
---
# Omniscripts Multi-Select Element

Enable users to select from multiple items by adding the Multi-select element to your Omniscript. Display options vertically, horizontally, or as an image. Read-only Multi-Select images show in grayscale, but you can use a custom CSS to them in color.

1. Select how to display the radio buttons.
    
    - **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](https://help.salesforce.com/s/articleView?id=xcloud.os_omniscripts_multi_select_element_16739.htm&release=264.0.0&type=5 "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.").
2. If you select **Image** as the display format, 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.
3. 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 the display format isn’t **Image**.
    - **Custom**: Enter the Apex class and method that returns the options. Use the format `ClassName.method`. See [Populating Picklist Values in Omniscript Inputs from Apex](https://help.salesforce.com/s/articleView?id=xcloud.os_populating_picklist_values_from_apex_21650.htm&release=264.0.0&type=5 "You can populate Select, Multi-select, and Radio elements from a Callable Apex class. 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.
4. If you select **Manual** or **Image** as an **Option Source**, for each option follow these steps:
    
    1. Click **Add 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.
        
        ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio-264-0-0-production-enus/f526eaa8-ae05-487a-8944-4bb99b0b78ac/images/icon_note.png)
        
        Note
        
        If you're using the Omnistudio standard runtime and standard designer without the Omnistudio managed package installed, you may encounter an error when uploading images. To resolve this issue, install the latest version of Omnistudio managed package. For installation instructions, see[Install or Upgrade the Omnistudio Managed Package](https://help.salesforce.com/s/articleView?id=xcloud.os_install_or_upgrade_the_omnistudio_package.htm&type=5&language=en_US).
    4. Select **Use as Default Value** to select the option by default.
5. 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`.
6. 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`.
7. 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.
8. For additional properties, see [Common Omniscript Element Properties](https://help.salesforce.com/s/articleView?id=xcloud.os_common_omniscript_element_properties_definitions__10687.htm&release=264.0.0&type=5 "Each Omniscript element has settings, some of which are unique to that element. Some settings are common among the elements, though some of these setting aren’t available in all elements. To edit these settings, use the Properties pane on the Designer.").

## Restore Color for Read-Only Multi-Select Element Images

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.

1. Create a ReadOnlyRestoreColor.css file with this code:
    
    ```
    .omni-read-only [data-omni-input] .slds-img-item_select-container, 
    .omni-read-only [data-omni-input] input[type=checkbox], 
    .omni-read-only [data-omni-input] input[type=radio], 
    .omni-read-only [data-omni-input] input[type=range] {
    	filter: brightness(1.25) grayscale(0) !important;
    }
    ```
2. From Setup, open Static Resources.
3. Click **New**.
4. In Name, enter ReadOnlyRestoreColor.
5. Click **Browse**, then select the ReadOnlyRestoreColor.css file.
6. Save your changes.
7. From the App Launcher, find and select **Omnistudio**, then click **Omniscripts**.
8. In the list of Omniscripts, Find and expand your Omniscript, then click the version.
    
    The Omniscript opens in the Omniscript Designer.
9. In the Omniscript Designer, click **Setup**.
10. Expand **Styling Options**.
11. In Custom Lightning Stylesheet File Name, enter ReadOnlyRestoreColor.