# \<nomatch>

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

The `<nomatch>` element is short for \<catch event=“nomatch”>.

#### Attributes <a href="#attributes" id="attributes"></a>

<table><thead><tr><th width="159.33333333333331">Name</th><th width="149">Data type<select><option value="e92c841836524e04abc2e835bdd9be3e" label="String" color="blue"></option><option value="bedc09e7819f41a8b4b04c658bf3b126" label="Integer" color="blue"></option><option value="0a127bbb366345bab1f1eb3bc0708119" label="Boolean" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td>count</td><td><span data-option="bedc09e7819f41a8b4b04c658bf3b126">Integer</span></td><td><p>(defaults to 1) The occurrence of the event. The count allows you to handle different occurrences of the same event differently.</p><p></p><p>Each &#x3C;form>, &#x3C;menu>, and form item maintains a counter for each event that occurs while it is being visited. These counters are reset each time the &#x3C;menu> or form item's &#x3C;form> is re-entered. The form-level counters are used in the selection of an event handler for events thrown in a form-level &#x3C;filled>.</p><p></p><p>Counters are incremented against the full event name and every prefix matching event name. For example, occurrence of the event “event.foo.1” increments the counters associated with handlers for “event.foo.1” plus “event.foo” and “event”.</p></td></tr><tr><td>cond</td><td><span data-option="e92c841836524e04abc2e835bdd9be3e">String</span></td><td>(defaults to true) An expression that must evaluate to true after conversion to Boolean in order for the event to be caught.</td></tr></tbody></table>

### Notes

None

### Example

```markup
<?xml version="1.0"?>
<vxml version="2.0">
  <form>
    <field name="user_id" type="digits?length=5">
      <prompt>
        Please enter your user identification number.
      </prompt>
      <filled>
        <prompt>
          You entered <value expr="user_id"/>. Goodbye.
        </prompt>
        <exit/>
      </filled>
      <nomatch count="1,2">
        <prompt>
          Your input was not valid. Your customer identification number should be the five digit number you received in your sign up email.
        </prompt>
        <reprompt/>
      </nomatch>
      <nomatch count="3">
        <prompt>
          It appears you are having difficulty with your customer identification number. Please try your call again later. Goodbye.
        </prompt>
        <exit/>
      </nomatch>
    </field>
  </form>
</vxml>
```

The output of the above script would be:

> Computer: Please enter your user identification number.\
> User: \<user enters: 1 2 3> (nomatch x1)\
> Computer: Your input was not valid. Your customer identification number should be the five digit number you received in your sign up email.\
> Computer: Please enter your user identification number.\
> User: \<user enters: 1 2 3 4> (nomatch x2)\
> Computer: Your input was not valid. Your customer identification number should be the five digit number you received in your sign up email.\
> Computer: Please enter your user identification number.\
> User: \<user enters: 2 2 2> (nomatch x3)\
> Computer: It appears you are having difficulty with your customer identification number. Please try your call again later. Goodbye. \*application hangs up\*

### Child Tags

[\<assign>](/dev/voicexml/tags/assign-tag.md), [\<audio>](/dev/voicexml/tags/audio-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),  [\<menu>](/dev/voicexml/tags/menu-tag.md), [\<record>](/dev/voicexml/tags/record-tag.md), [\<subdialog>](/dev/voicexml/tags/subdialog-tag.md), [\<transfer>](/dev/voicexml/tags/transfer-tag.md), [\<vxml>](/dev/voicexml/tags/vxml-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/nomatch-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.
