---
schema_version: "1"
id: b765f7a7f1c672131a618ebe1f31db9fbbd1ee85f4dad091caf2fdaae58b2bcc
title: isselect Element
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/b2c-commerce/guides/isml/b2c-isselect.md
canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/b2c-isselect.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 25130ee985ee1a6bcab30dfff7f1daa197c552a59c0f4373d06a6a8e5ffebf3c
products:
  - Composable Storefront
  - Salesforce APIs
---
# isselect Element

Implementdrop-down list boxes in an HTML form.

## Syntax

```
<isselect
  name        = simple_name       \\required
  iterator    = loop_var          \\required
  description = box_text          \\required
  value       = text_value        \\required
  condition   = "true" | "false"
  encoding    = "on" | "off"
/>
```

- name = simple_name

  - : _Allowed data type:_ string or expression.

    `simple_name` is a name for your list box. Note that the name you specify here is used when the browser sends the user selection as a key-value pair to the server. Therefore, the specified name must be equal to the input parameter required by the pipeline that processes the form values.

- iterator = loop_var

  - : `loop_var` specifies a loop variable. All elements of the loop variable are added to the list box.

- description = box_text

  - : `box_text` is text that is shown in the drop-down list box.

- value = text_value

  - : `text_value` is text sent back by the browser to the server as the value of a key-value pair. This can be used, for example, to return an internal product ID instead of the product name shown in the drop-down list box. The string specified by value is stored in the pipeline dictionary. The appropriate key is determined by the `<isselect>` attribute name.

- condition = "true" | "false"

  - : _Allowed data type:_ expression. String is not allowed.

    If condition is true, the appropriate list element is preselected. This has its counterpart in the selected attribute of the `<option>` HTML tag. Make sure that only one list element matches the condition to avoid undefined results in the browser.

- encoding = "on" | "off"

  - : _Allowed data type:_ expression. String is not allowed.

    Default value is `on`. With this attribute you can explicitly switch automatic HTML encoding of the output on and off. Encoding means converting any special characters, such as `<,` `>`, `&`, `"`, as well as the named characters of the HTML 3.2 (Unicode 160-255) into their HTML counterparts. For example, the character `>` is converted to the string `&gt;`.

## Purpose

`<isselect>` replaces the HTML tag `<select>` and its supporting tags. With the iterator attribute you can specify an iterator, whose elements appear in the list box. One element in the list box can be preselected by specifying a condition with the condition attribute. Make sure that the specified condition evaluates to true for only one element of the list, otherwise the browser might not show the list properly.

## Example

In this example, `<isselect>` adds all elements of the iterator to an HTML list box that is generated.

```
<form action =... >
<isselect name = "PaymentMethodUserSelection"
iterator = "${PaymentMethodChoices}"
condition = "${PaymentMethod == PaymentMethodChoices}"
value = "${PaymentMethodChoices.UUID}"
description = "${PaymentMethodChoices.description}">
...
</form>
```