Text List

Improve this page


The text list field creates a simple text input with text list feature. You are able to select multiple values from the predefined list.

This field uses jQuery UI library to perform the text list action.


text list


Besides the common settings, this field has the following specific settings:

Name Description
options Array of 'placeholder' => 'label' for the inputs.

Sample code

    'id'      => 'text_list',
    'name'    => 'Text List',
    'type'    => 'text_list',

    'clone' => true,

    // Options: array of Placeholder => Label for text boxes
    // Number of options are not limited
    'options' => array(
        'John Smith'      => 'Name',
        'name@domain.com' => 'Email',


This field always stored the value as a serialized indexed array in a single row in the database. Each value in the array is the value of input defined in the options setting.

If the field is cloneable, then the value is stored as a serialized array of values in a single row in the database.

Template usage

If field is not cloneable:

$values = rwmb_meta( $field_id );
echo $value[0]; // Name
echo $value[1]; // Email

If field is cloneable:

$values = rwmb_meta( $field_id );
foreach ( $values as $value ) {
    echo $value[0]; // Name
    echo $value[1]; // Email

If you want to just display the value of this field in a table, use this code:

rwmb_the_value( $field_id );

which outputs:

text list output


        <td>Name 1</td>

Read more about rwmb_meta() and rwmb_the_value().