> For the complete documentation index, see [llms.txt](https://docs.plumvoice.com/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plumvoice.com/dev/voicexml/tags/filled-tag.md).

# \<filled>

## \<filled> <a href="#filled" id="filled"></a>

The `<filled>` element specifies an action to perform when some combination of input items is filled by user input. It may occur in two places: as a child of the `<form>` element, or as a child of an input item.

### Attributes

<table><thead><tr><th width="164.33333333333331">Name</th><th width="147">Data type<select><option value="3258829c9aef4bd4bfe4108bf8f9594f" label="String" color="blue"></option><option value="15069f4965784c8594ab4a0314128b01" label="Integer" color="blue"></option><option value="9af45b09f35245d889aa94ef3b512096" label="Boolean" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td>mode</td><td><span data-option="3258829c9aef4bd4bfe4108bf8f9594f">String</span></td><td><p>(defaults to all) Accepted values are "all" or "any".</p><p></p><p>If set to "any", this action is executed when any of the specified input items is filled by the last user input.</p><p></p><p>If set to "all", this action is executed when all of the mentioned input items are filled, and at least one has been filled by the last user input.</p><p></p><p><strong>Note:</strong> A &#x3C;filled> element in an input item cannot specify a mode.</p></td></tr><tr><td>namelist</td><td><span data-option="3258829c9aef4bd4bfe4108bf8f9594f">String</span></td><td><p>The input items to trigger on. </p><p></p><p>For a &#x3C;filled> in a form, namelist defaults to the names (explicit and implicit) of the form's input items.</p><p></p><p>A &#x3C;filled> element in an input item cannot specify a namelist; the namelist in this case is the input item name. Note that control items are not permitted in this list.</p></td></tr></tbody></table>

### Notes

None

### Example

```markup
<?xml version="1.0"?>
<vxml version="2.0">
  <form>
    <field name="myprompt" type="digits">
      <prompt>
        Say the magic number between 1 and 9.
      </prompt>
      <filled>
        <if cond="myprompt==5">
          <prompt>
            You guessed correctly!
          </prompt>
        <elseif cond="myprompt==4 || myprompt==6"/>
          <prompt>
            You're close. Try again.
          </prompt>
          <clear namelist="myprompt"/>
        <else/>
          <prompt>
            Try again.
          </prompt>
          <clear namelist="myprompt"/>
        </if>
      </filled>
    </field>
  </form>
</vxml>
```

The output of the above script would be:

> Computer: Say the magic number between one and nine.\
> Human: Three.\
> Computer: Try again. Say the magic number between one and nine.\
> Human: Six.\
> Computer: You're close. Try again. Say the magic number between one and nine.\
> Human: Five.\
> Computer: You guessed correctly!

### Child Tags

[\<audio>](/dev/voicexml/tags/audio-tag.md), [\<assign>](/dev/voicexml/tags/assign-tag.md), [\<clear>](/dev/voicexml/tags/clear-tag.md), [\<data>](/dev/voicexml/tags/data-tag.md), [\<disconnect>](/dev/voicexml/tags/disconnect-tag.md), [\<enumerate>](/dev/voicexml/tags/enumerate-tag.md), [\<exit>](/dev/voicexml/tags/exit-tag.md), [\<foreach>](/dev/voicexml/tags/foreach-tag.md), [\<goto>](/dev/voicexml/tags/goto-tag.md), [\<if>](/dev/voicexml/tags/if-tag.md), [\<log>](/dev/voicexml/tags/log-tag.md), [\<prompt>](/dev/voicexml/tags/prompt-tag.md), [\<reprompt>](/dev/voicexml/tags/reprompt-tag.md), [\<return>](/dev/voicexml/tags/return-tag.md), [\<script>](/dev/voicexml/tags/script-tag.md), [\<submit>](/dev/voicexml/tags/submit-tag.md), [\<throw>](/dev/voicexml/tags/throw-tag.md), [\<value>](/dev/voicexml/tags/value-tag.md), [\<var>](/dev/voicexml/tags/var-tag.md)

### Parent Tags

[\<field>](/dev/voicexml/tags/field-tag.md), [\<form>](/dev/voicexml/tags/form-tag.md), [\<record>](/dev/voicexml/tags/record-tag.md), [\<subdialog>](/dev/voicexml/tags/subdialog-tag.md), [\<transfer>](/dev/voicexml/tags/transfer-tag.md)