---
updatedAt: 2026-03-30T09:13:18.000Z
agentTools:
  projectIndex: https://developers.bazaarvoice.com/v1.0-ConversationsAPI/llms.txt
---

# Input Types

This tutorial describes the input types available for **Full Submission** in the Bazaarvoice Conversations API. Developers will learn how to use the Type property to determine what graphical user interface elements to use in their applications.

# Overview

The `Type` property indicates the form of data the Conversations API expects to receive for a particular input.

The following snippet demonstrates the `Type` property in an API submission response:

```json
"isrecommended": {  
    "Default": null,  
    "MaxLength": null,  
    "Value": "false",  
    "Required": false,  
    "Type": "BooleanInput",  
    "Label": null,  
    "Id": " isrecommended ",  
    "MinLength": null,  
    "Options": [ ]  
},
```

> 📘 The code snippets in this tutorial come from Conversations API submission requests and represent the information needed to create form inputs in your application.

# Available types

These types identify the kind of data that should be submitted for a particular input:

| Types                                                                                                  | Descriptions                                      |
| :----------------------------------------------------------------------------------------------------- | :------------------------------------------------ |
| [BooleanInput](https://developers.bazaarvoice.com/v1.0-ConversationsAPI/docs/input-types#booleaninput) | One of either "true" or "false" is expected.      |
| [FileInput](#fileinput)                                                                                | Used with image or video uploads.                 |
| [IntegerInput](#integerinput)                                                                          | Indicates value must be an integer.               |
| [SelectInput](#selectinput)                                                                            | One of several predetermined options is expected. |
| [TextAreaInput](#textareainput)                                                                        | Free form text and line breaks are expected.      |
| [TextInput](#textinput)                                                                                | Free form text without line breaks are expected.  |

## BooleanInput

```json
"Type": "BooleanInput"
```

Boolean inputs accept either "true" or "false" responses. They are typically used for inputs that allow the content author to indicate agreement with a statement or select from a list of values where each statement or option is a different API field. This could mean selecting several predetermined pro or con values, agreeing to a terms and conditions, indicating a statement is relevant to them or answering a yes/no question.

The following code samples demonstrate `BooleanInput`:

[block:html]
{
  "html": "<img style=\"border: 1px solid #000\" src=\"//dkv97bqrmxzll.cloudfront.net/img/conversations-api/bool_email.png\" alt=\"Boolean input using checkbox.\" title=\"Boolean input using checkbox.\">"
}
[/block]

Response from Bazaarvoice API submission preview request:

```json
"sendemailalertwhenpublished": {  
    "Default": null,  
    "MaxLength": null,  
    "Value": "true",  
    "Required": false,  
    "Type": "BooleanInput",  
    "Label": null,  
    "Id": "sendemailalertwhenpublished",  
    "MinLength": null,  
    "Options": [ ]  
},  
"sendemailalertwhencommented": {  
    "Default": null,  
    "MaxLength": null,  
    "Value": "",  
    "Required": false,  
    "Type": "BooleanInput",  
    "Label": null,  
    "Id": "sendemailalertwhencommented",  
    "MinLength": null,  
    "Options": [ ]  
},
```

Example of a valid value in submission POST request:

```
&sendemailalertwhenpublished=true&sendemailalertwhencommented=false
```

## FileInput

```json
"Type": "FileInput"
```

The FileInput type indicates that a photo or video is expected.

[block:html]
{
  "html": "<img width=\"50%\" style=\"border: 1px solid #000\" src=\"//dkv97bqrmxzll.cloudfront.net/img/conversations-api/fileinput_photo.png\" alt=\"File upload input\" title=\"File upload input\">"
}
[/block]

Response from Bazaarvoice to API submission preview request:

```json
"photo": {  
    "Default": null,  
    "Required": null,  
    "Value": null,  
    "MaxLength": null,  
    "Type": "FileInput",  
    "Label": null,  
    "Id": "photo",  
    "MinLength": null,  
    "Options": [ ]  
}
```

Example of a valid value in submission POST request:

```
&photo={binary_data}
```

## IntegerInput

```json
"Type": "IntegerInput"
```

The IntegerInput type indicates that the value being submitted should be an integer.

[block:html]
{
  "html": "<img width=\"50%\" style=\"border: 1px solid #000\" src=\"//dkv97bqrmxzll.cloudfront.net/img/conversations-api/integerinput_overall.png\" alt=\"Overall rating IntegerInput\" title=\"Overall rating IntegerInput\">"
}
[/block]

Response from Bazaarvoice to API submission preview request:

```json
"rating": {  
    "Default": null,  
    "Value": null,  
    "MaxLength": null,  
    "Required": true,  
    "Type": "IntegerInput",  
    "Label": null,  
    "Id": "rating",  
    "MinLength": null,  
    "Options": [ ]  
},
```

Example of a valid value in submission POST request:

```
&rating=4
```

## SelectInput

```
"Type": "SelectInput"
```

SelectInput inputs are questions for which the available options have been predetermined. Inputs associated with this type typically present the content author with a:

* single select multiple choice style list of options
* range of values from which the user may make on selection

### List of options

[block:html]
{
  "html": "<img width=\"50%\" style=\"border: 1px solid #000\" src=\"//dkv97bqrmxzll.cloudfront.net/img/conversations-api/selectinput_cdv.png\" alt=\"SelectInput dropdown\" title=\"SelectInput dropdown\">"
}
[/block]

Response from Bazaarvoice to API submission preview request:

```json
contextdatavalue_Gender": {  
    "Default": null,  
    "Value": null,  
    "MaxLength": null,  
    "Required": false,  
    "Type": "SelectInput",  
    "Label": "What is your gender?",  
    "Id": "contextdatavalue_Gender",  
    "MinLength": null,  
    "Options": [  
        {  
            "Value": "",  
            "Selected": true,  
            "Label": ""  
        },  
        {  
            "Value": "Male",  
            "Selected": false,  
            "Label": "Male"  
        },  
        {  
            "Value": "Female",  
            "Selected": false,  
            "Label": "Female"  
        }  
    ]  
},
```

Example of a valid value in submission POST request:

```
&contextdatavalue_Gender=Female
```

### Range of values

[block:html]
{
  "html": "<img width=\"50%\" style=\"border: 1px solid #000\" src=\"//dkv97bqrmxzll.cloudfront.net/img/conversations-api/selectinput_slider.png\" alt=\"Rating dimension SelectInput\" title=\"Rating dimension SelectInput\">"
}
[/block]

Response from Bazaarvoice to API submission preview request:

```json
"rating_Sliders": {  
    "Default": null,  
    "Value": null,  
    "MaxLength": null,  
    "Required": false,  
    "Type": "SelectInput",  
    "Label": "sliders",  
    "Id": "rating_Sliders",  
    "MinLength": null,  
    "Options": [  
        {  
            "Value": "1",  
            "Selected": false,  
            "Label": "too small"  
        },  
        {  
            "Value": "2",  
            "Selected": false,  
            "Label": "a little small"  
        },  
        {  
            "Value": "3",  
            "Selected": false,  
            "Label": "as expected"  
        },  
        {  
            "Value": "4",  
            "Selected": false,  
            "Label": "a little large"  
        },  
        {  
            "Value": "5",  
            "Selected": false,  
            "Label": "too large"  
        }  
    ]  
},
```

Example of a valid value in submission POST request:

```
&rating_Sliders=3
```

## TextAreaInput

```json
"Type": "TextAreaInput"
```

A TextAreaInput is used for longer answers that can include line breaks or paragraphs.

[block:html]
{
  "html": "<img width=\"75%\" style=\"border: 1px solid #000\" src=\"//dkv97bqrmxzll.cloudfront.net/img/conversations-api/textareainput_review.png\" alt=\"TextAreaInput\" title=\"TextAreaInput\">"
}
[/block]

Response from Bazaarvoice to API submission preview request:

```json
"reviewtext": {  
    "Default": null,  
    "Value": null,  
    "MaxLength": 10000,  
    "Required": false,  
    "Type": "TextAreaInput",  
    "Label": null,  
    "Id": "reviewtext",  
    "Options": [ ],  
    "MinLength": 50  
},
```

Example of a valid value in submission POST request:

```
&reviewtext=Proin%20quis%20erat%20facilisis%3B%20tempus%20eros%20in%2C%20tincidunt%20tellus.%0A%0ASed%20aliquam%20volutpat%20viverra.%20Nulla%20tellus%20magna%2C%20porta%20quis%20felis%20in%2C%20blandit%20hendrerit%20diam.
```

The example above is [percent encoded](https://en.wikipedia.org/wiki/Percent-encoding). Note line breaks are represented by `%0A%0A`.

> 🚧 Bazaarvoice does not support marked-up user generated content. You should not allow, encourage or enable authors to submit content that includes HTML.

## TextInput

```json
"Type": "TextInput"
```

TextInput inputs accept a short answers with no line breaks, typically consisting a single word or short sentence/phrase.

[block:html]
{
  "html": "<img width=\"75%\" style=\"border: 1px solid #000\" src=\"//dkv97bqrmxzll.cloudfront.net/img/conversations-api/textinput_title.png\" alt=\"TextInput\" title=\"TextInput\">"
}
[/block]

Response from Bazaarvoice to API submission preview request:

```json
"title": {  
    "Default": null,  
    "Value": null,  
    "MaxLength": 50,  
    "Required": false,  
    "Type": "TextInput",  
    "Label": null,  
    "Id": "title",  
    "Options": [ ],  
    "MinLength": 0  
},
```

Example of a valid value in submission POST request:

```
&title=Proin%20quis%20erat%20facilisis%3B%20tempus%20eros%20in%2C%20tincidunt%20tellus.
```

The above example is [percent encoded](https://en.wikipedia.org/wiki/Percent-encoding).

> 🚧 Bazaarvoice does not support marked-up user generated content. You should not allow, encourage or enable authors to submit content that includes HTML tags.