Document Tree
Document Properties
Last Modified
Added to KB
Public Access
Doc Type
  • ICM 7.10
  • ICM 11



Short Description

implements drop-down list boxes in an HTML form; replaces the HTML tag <SELECT> and its supporting tags

Table of Contents

Product Version


Product To Version


StatusNew Labels


<ISSELECT> can be used for easily implementing drop-down list boxes in an HTML form. <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 may not display the list properly.


  name = "( {a name} | {ISML expression} )"
  iterator = "{ISML variable identifier}"
  [ condition = "{ISML expression}" ]
  value = "{ISML expression}"
  description = "{ISML expression}"
  [ encoding = "( on | off )" ]
  [ disabled = "( true | false )" ]


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#">



This attribute is required.
name = simple name
Specify a name for your list box.


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 will process the form values.


This attribute is required.
iterator = loop variable
Specifies a loop variable. All elements of the loop variable are added to the list box.


This attribute is required.
value = string
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 displayed to the buyer. The string specified by value is stored in the pipeline dictionary. The appropriate key is determined by the <ISSELECT> attribute name.


This attribute is required.
description = string
Text that is displayed to the buyer in the drop-down list box.


This attribute is optional.
condition = Boolean ISML Expression
If condition is true, the appropriate list element is pre-selected. 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 unknown results in different browsers.


This attribute is optional.
encoding = on | off
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 any named characters of HTML 4.01 (Unicode 160-255) into their HTML counterparts. For example, <ISPRINT>converts the character > to the string \&gt\;.


This attribute is optional.
disabled = true | false
If set to true, this attribute will disable the select box. The default value is false.

Reference - ISML Tags

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to if you experience login issues,
or if you want to register as customer.