# \<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)


---

# 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.plumvoice.com/dev/voicexml/tags/filled-tag.md?ask=<question>
```

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.