# List {% embed url="" %} This question type allows a list of options to be displayed for the Operator to select from.

### **Properties** **Admin Display** – a descriptive name to identify the Question.\ \ **Operator Display** - the Question text as displayed to the Operator.\ \ **Asset Data** – see [this page](/product-suite/admin/entities/asset-data.md) for more details.\ \ **Enable text input on final option** - check this to allow freeform text to be entered. **Hotspot Image** - (Keyfax version 4.4.7 or later) clicking this button presents an image selection pop-up allowing the user to upload a new image or select an existing. The images are uploaded to and available from the 'List Question Hotspot Image' group of images. Once an image is selected the List Question is no longer presented as a list of text items to be chosen - but, instead, a single image with hotspots that can be clicked to answer the question. Hotspot areas can also (optionally) contain the text of the answer that the user is accepting with some control over the text placement. Clearing the hotspot image reverts the question display in the web environment back to a text list (assuming that all icon images have also be removed - if not the web will display the question as an icon list). {% embed url="" %} ### **Options** **Display Prompt** – the text of the option to be displayed to the Operator. **Return Value** – the text to be stored in a Databox or appended to the recorded text (breadcrumb). If this is left blank the ‘Display Prompt’ will be entered. A value will only be entered if the Rec(ord) box is ticked, as shown above. **Icon Image** – (Keyfax version 4.4.7 or later) if this cell is clicked with the mouse an image selection pop-up appears allowing the user to upload a new image or select an existing. The images are uploaded to and available from the 'List Question Answer Image' group of images. Once an image is selected for any of the answers the List Question is no longer presented as a list of text items to be chosen - but, instead, a list of images with text beneath each that can be selected. Clearing all answer images reverts the question display in the web environment back to a text list (assuming that no hotspot image is selected). {% embed url="" %} ### Re-ordering, adding or deleting options Controls on the right hand side allow you to change the order of the prompts and Add or Delete options. {% hint style="info" %} The Delete button (and up/down buttons to re-sequence options) are disabled **if any referencing script is being edited**. If an Option List question is being edited, then it is not available for use in a script edit. {% endhint %} ### User Experience Without images (both hotspot and all icon images are cleared):

With a hotspot image (Keyfax version 4.4.7 or later):

With icon images (with hotspot image cleared - Keyfax version 4.4.7 or later):

--- # 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.keyfax.biz/product-suite/admin/entities/questions/list.md?ask= ``` 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.