# Multiple Select

## **Element Description**

The **Multiple Select** field allows users to choose more than one option from a multiple-select field. This field is ideal when you need to provide customers with the ability to select multiple options from a predefined set during checkout.

<figure><img src="/files/LBWx3715tFFKmgtwtuKO" alt=""><figcaption></figcaption></figure>

**Sample Use Cases**

* Allow customers to select multiple product preferences.
* Provide an option to choose several delivery or packaging methods.
* Let customers pick multiple subscription preferences or product features.

<figure><img src="/files/8QfR04vk6h5dAv2YJwFo" alt=""><figcaption><p>Multiple Select</p></figcaption></figure>

## **Multiple Select** Field Settings

<figure><img src="/files/89caVVYAAcEnLBpwaA2K" alt=""><figcaption></figcaption></figure>

* **Label** – The name of the field displayed to the customer on the checkout page.
* **Placeholder** – The text is displayed inside the dropdown before the customer makes a selection.
* **Description** – Additional information or instructions about the multiple select fields, are shown below the dropdown.
* **Enable/Disable Field** – Allows you to enable or disable the field based on your needs. If it is disabled, the element will not be displayed in the checkout form, you can enable it anytime from the checkout builder according to your needs.
* **Is Required** – When enabled, customers must select at least one option before proceeding with checkout.
* **Options** – Customize the available options by setting the **Label** (what the customer sees) and **Value** (backend value associated with each option). You can add, edit, or delete options as needed:
  * <picture><source srcset="/files/CQ5w306TciOPhW3B4guz" media="(prefers-color-scheme: dark)"><img src="/files/rt8oYLpasni9HbZS7eaK" alt=""></picture> - use the drag-and-drop function to reorder options
  * <picture><source srcset="/files/tOITZpAUWY6z1kZEkM7z" media="(prefers-color-scheme: dark)"><img src="/files/6J4mJDVz4WZHSRR1FazY" alt=""></picture> - use this to delete the options
  * **Add new** - use this button to add new options
* **Default Value(s)** – Pre-select one or more options that will appear as default selections when the page loads.

**Advanced Settings**

* **Custom Class Name** – Add[ **custom CSS classes**](/checkout-custom-fields-builder-for-woocommerce/plugin-features/custom-classes.md) for further styling or additional functionality for the multiple select fields.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stylemixthemes.com/checkout-custom-fields-builder-for-woocommerce/checkout-builder-elements/multiple-select.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
