# Menu
## **Function**
This module provides users with a way to branch on, and collect complex input.
Menus enable users to create multiple choice questions where each option is associated with a value, where it will be saved to the menu variable upon a valid entry.
Options can be added or removed with the add / remove buttons (
). The maximum number of options available in the module is 10, with a minimum choice of 1.
## **Audio Prompts**
With this module, in addition to the user prompt text (“*Welcome to the sample menu.*”
), built-in prompts (
) entry will be automatically created in the [Prompt Table](https://docs.plumvoice.com/fuse/audio-manager#prompt-table) for every menu option available. (“For *value*, press *DTMF*.”
)
### **Clearing Prompts**
| |  |  |
| --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- |
| The built-in prompt can be changed to a different text, or blank out completely if the entire menu resides within the user prompt text. | 
| 
|
### **Repeat**
| | |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| In the scenario where there is a repeat option, if there are no inputs, or if the caller entered an invalid choice, the entire module prompts will be repeated to the caller.
If there are any portion of the voice prompts that should not be repeated, they should be separated out in a Prompt (
) module before the menu system,
| 
|
### **Branching**
If the user input matches one of the menu options that is listed, the call flow will follow the path to the node on the side of the menu option (
).\
If the option node is not connected (
), then call-flow will go through the bottom node of the module (
).
This can be useful to capture multiple selections that follows the call flow without needing to create a link for all the options available. The menu variable can then be used to determine the value that was set.
See the following example:
| |  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| The call reaches the fruit\_menu module that awaits for a DTMF entry
The call path will be different depending on the caller's input:
1: Goes right to apple\_menu
2-5: Goes down to fruit\_result\_prompt
Other: No Match error
| 
|
## **Module Settings**
### [Barge In](/fuse/module-settings.md#barge-in)
| | |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| This setting allows callers to interrupt a prompt before it finishes playing.
When enabled, DTMF input interrupts the prompt and progresses the call forward in the call-flow. If speech recognition is enabled on the ensuing module in the call-flow, then end-users can also interrupt the prompt with a spoken utterance, too. Disabling barge-in forces callers to listen to the entire prompt.
A barge-in enabled module will have a dashed line on top of the text box. See example here.
|
### [**Enable Speech Input (Menu)**](/fuse/module-settings.md#enable-speech-input-menu)
| | |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| This setting enables Automatic Speech Recognition (ASR) for the menu module.
A green microphone (
) icon appears in the module when this is enabled.
Enabling speech recognition generates an additional column in the module called ‘Utterance’.
Each option line includes a DTMF input, a speech utterance, and a corresponding value.
The DTMF and speech inputs can be different, as the system expects the utterance as speech input, but the menu variable will carry the actual value.
With the example above, if the user press 1 or says “Eastern”, the sample\_voice\_menu variable will carry the value “est”.
Note: Utterance is required to be filled when expecting any speech input. Even if the utterance is the same as value, the utterance field cannot be blank.
For accepting multiple utterances for a selection, a new, separate choice needs to be created and they can both branch into the same module, or have the same value.
The audio manager auto-generates prompts for these options in the format of “For \, Press \ or say \”.
To set the utterance for other languages in the application, the corresponding language tab in audio manager will have an utterance entry for each choice, along with an utterance icon (
) in the left and the primary language text underneath for identification.
|
### [**Interdigit Timeout**](/fuse/module-settings.md#interdigit-timeout)
|  | This allows users to set the maximum time, in seconds, that elapse between inputting digits before returning a timeout error. This applies to all input modules that accept multiple digits, like Date/Time, Number, and Digits.
The default value is 1 second. Acceptable number values range from 1 to 60.
|
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### [Private](/fuse/module-settings.md#private)
| | |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 
| This setting controls the logging function of a module.
Enabling the 'Private' setting instructs the module to not record, report, or retain the information input to that module for reporting or any other purposes. When enabled any information entered into a module during a call will be lost immediately when the call terminates.
The 'Private' setting is critical for businesses that need to maintain PCI-DSS or HIPAA compliance.
The module icon, in the upper left-hand corner, becomes grayed-out when this setting is enabled. See more details here.
|
### [**Show Custom Errors**](/fuse/module-settings.md#show-custom-errors)
| | |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| Enabling this setting overrides the default, global error options set in the Application Settings > User Input Settings.
This allows users to establish custom error handling in order to act on errors in a specific way in that module.
Instead of progressing to the next module in the call-flow, custom error handling allows users to re-prompt the same module, to provide a custom error message, to re-direct the call based on the error, or any other desired behavior.
Adding multiple errors () to a module functions behave the same way as a counter.
The first error follows the path for the first error listed, if a second error occurs in the same module it follows the second listed error, and so on until all errors are exhausted or an error directs the end-user away from that module.
No Input occurs when the caller does not provide an input based on the timeout settings.
This is based on the “Initial input timeout” in User Input Settings
No Match occurs when the caller input does not match the module's criteria for the input module.
|
### [Timeout Length](/fuse/module-settings.md#timeout-length)
| | |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| This allows users to set the maximum time, in seconds, that elapse before returning a timeout error. This applies modules that fetch outside scripts, like the SOAP, REST, or subdialog modules.
The default value for Timeout Length is 30 seconds.
Acceptable number values range from 1 to 120.
|
### **Advanced Settings**
Advanced Fuse users may want to use shadow variables that are available with input modules. For more information on this functionality, please visit the [Shadow Variables](/fuse/variables/shadow-variables.md) page.
---
# 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/fuse/input/menu.md?ask=
```
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.