You are here:
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.
-
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.
-
-
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.
-
-
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. -
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.
-
-
If you select Manual or Image as an
Option Source, for each option follow these steps:
-
Click Add Option.
-
Enter the Value and visible Label.
-
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.
NoteIf 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, seeInstall or Upgrade the Omnistudio Managed Package.
-
Select Use as Default Value to select the option by default.
-
-
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. -
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. -
To display options based on the selection of another value, configure
Controlling Field Type by following these steps:
-
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.
-
-
In Controlling Field Source, enter an Apex class.
-
In Controlling Field Element, enter an Omniscript element name.
-
- For additional properties, see Common Omniscript Element Properties.
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.
-
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; } - From Setup, open Static Resources.
- Click New.
- In Name, enter ReadOnlyRestoreColor.
- Click Browse, then select the ReadOnlyRestoreColor.css file.
- Save your changes.
- From the App Launcher, find and select Omnistudio, then click Omniscripts.
-
In the list of Omniscripts, Find and expand your Omniscript, then click the
version.
The Omniscript opens in the Omniscript Designer.
- In the Omniscript Designer, click Setup.
- Expand Styling Options.
- In Custom Lightning Stylesheet File Name, enter ReadOnlyRestoreColor.

