Multi-Select

The Multi Select control allows a user to choose multiple options from a predefined list.

The Multi Select control is an input component that allows a user to select one or more options from a list of predefined choices, typically presented as checkboxes.

When to Use

Use the Multi Select control when you want to allow the user to choose any number of options from a list. This is useful for:

• Selecting multiple features to include in a report.

• Choosing several topics to write about.

• Tagging an item with multiple categories.

• Specifying a list of recipients for a notification.

How to Add

1. From your workflow's Build page, click on + Add Input.

2. Select Multi Select from the list of available controls.

Configuration

• Title: The main label for the group of choices.

• Description: Optional helper text to provide more context.

• Options: This is where you define the items that will appear as choices. Add one option per line.

• Variable Name: The name used to access the list of the user's selected values.

• Optional/Required: A toggle to specify if the user must make at least one selection.

Setting Default Values

You can pre-select any number of options as the default:

1. Add all your desired options to the Options list.

2. Check the boxes next to the options you want to be selected by default.

3. Click the settings icon (⚙️) at the bottom right of the control.

4. Select Set Current Value as Default.

Accessing the Value

The Multi Select control outputs a list (or array) of strings, where each string is one of the selected options. You access this list using its variable name in double curly braces {{}}.

For example, if the variable name is features:

• The value of {{features}} would look like ["SEO Analysis", "Competitor Tracking"].

• You can pass this directly to an LLM, which can iterate through the list in its response.

• In a Map Node, you can use this list as the input to run a sub-workflow for each selected feature.

Example

Goal: Allow a user to select multiple social media platforms and then draft a post for each one.

1. Add a Multi Select Control:

   • Title: "Select Platforms"

   • Variable Name: platforms

   • Options:

     Twitter
     LinkedIn
     Facebook

2. Add a Long Text Input:

   • Title: "Core Message"

   • Variable Name: message

3. Add a Map Node:

   • Input List: {{platforms}}

   • Sub-Workflow:

     • Sub-Node 1: OpenAI MCP

       • Action: Chat

       • Prompt: `Rewrite the following message to be appropriate for the {{item}} platform:

         {{message}}`

       • Note: {{item}} refers to the individual platform name for each iteration (e.g., "Twitter").

4. Add a Save to File Node:

   • Content: The collected list of drafted posts will be saved: {{map_1.output}}