---
title: "List input"
canonical: "https://support.appfire.com/space/CLSL/656676649/List%20input"
format: markdown
---
> Macro (aura-html)

Defines a column as a text input. 

<span style="color: #ffffff">o</span>> Macro (inline-media-image)

  
The  `list-input `macro is added to the checklist macro to define an input column for the list.

<span style="color: #ffffff">o</span>> Macro (inline-media-image)



**Edit** the `list-input `macro to add the name of the column heading.

<span style="color: #ffffff">o</span>> Macro (inline-media-image)



The `list-input `macro can be configured to store the input column list values either:

- on the page listed in the row of the entered value.
- on the current page of the checklist.

The default entry value is 20 characters maximum. 

The `list-input `macro can also be configured to display values as read-only.

<span style="color: #ffffff">o</span>> Macro (inline-media-image)



This is useful when the macro is added to other content but you only want the column list values to be edited on a specific page(s) with the added macro. The column values storage needs to be set to be on the row pages.

The macro allows the column values to be sorted by a number of entry types including

- **string** (S)
- **integer** (I)
- **date** (D)

 You can also set the column as **already sorted** (A) to prevent sorting the list on this input column.

The column values are stored as metadata values (see `storage type` parameter in the table below).

See also [Example 4](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655891543).

### Parameters

| parameter | Mandatory? | Default | Description | Comments |
| --- | --- | --- | --- | --- |
| `heading` | yes |  | The heading of the column |  |
| `Input Character Width` | yes | 20 | The maximum number of characters read |  |
| `storage type` | no | `rows` | Determines where to store the value. Use `rows` to store the values for this column into the pages representing each row (metadata value name is `<Column Heading>`), or `checklist` to store the values into the page containing the checklist (metadata value name is `<Column Heading>.<Space Key>:<Row page title>`) | `store=checklist` not supported with Comala Boards |
| `sorttype` | no | `S` | Type of value to be used to sort the table by this column. Values could be any of A: Already sorted; C: Currency; D: Date; F: Float; I: Integer; S: String |  |
| `width` | no |  | Width of the column |  |
| `readonly` | no | `false` | Whether or not the column is read-only |  |
| `CSS class` | no |  | The style sheet (CSS) class to use for the cells |  |

**Example**

```
{list-input:cols=20|heading=Common pet names|store=checklist}
```

| [Back to Lists User Guide](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=clsl&title=User%20Guide&linkCreation=true&fromPageId=656676649) |
| --- |
| ### **[list-input example](https://appfire.atlassian.net/wiki/spaces/CLSL/pages/655891543)** |