Welcome to the OpenCities help centre. Search for what you're after, or browse the categories.
Can't find what you're looking for? Submit a support ticket and we'll be in touch.


Form field input types explained

avatar of OpenCities Product Team

OpenCities Product Team

Last updated

This is a legacy form building tool and will not be supported or updated in a future product release. For a fully supported form building tool, we recommend using OpenForms. For more information on OpenForms, see Use OpenForms with OpenCities and the OpenForms help centre.

Use the appropriate field type to create your form questions and collect response data. To select an input type, click on the '+' symbol and the field will appear below the input type area.

Label field

Used to create section headers within the form. As the form is entered into the WYSIWYG area of a page, content can be added around the form. The label field is used to title sections within the form itself e.g. Section 1 - Contact Details, Section 2 - Employment Details etc.

Enter text by placing the cursor directly into the field. No response is required.

Textbox and Textarea fields

This field allows the respondent to provide a response using text.

  • A Textbox input field is used to provide short, one line answers
  • A Textarea input field is used for longer answers (paragraphs) which allows more response space to review text.

Place the cursor in the label area to enter the question text, then click on the pencil icon to the left to edit the field properties.

Field descriptions for textbox and textarea

  Field Function/Description
1 Value Predefined value added to the response box
2 Required field Assigns this as a mandatory field. If selected, ensure you fill in the Validation message field.
3 Number Field will only accept numeric characters
4 No. of decimal Number of characters accepted for this field
5 Email Field will only accept characters configured as an email address
6 Respondent Appears if Email is selected, to identify field as the Respondents email address. This is the address used for the Autoresponder message set up in Submission.
7 Max length Number of characters accepted for this field
8 Regular expression Code used to set the input response pattern. It is used to specify a set of strings or a character configuration for a particular purpose e.g. a request ID 'ABCD-1234' can be coded to only access the configuration of 4 letters, a dash and 4 numbers.
9 Validation message Appears after form submission attempt to advise the respondent that they have not filled in a required field correctly. The form will not be submitted until they has satisfied the field response requirements e.g. mandatory field not completed or text used when field has been set to only accept numbers.
10 Description Overview of field for internal use

When you have completed the settings, click update to save and condense the settings window.

Settings screen for textarea and textbox fields

Combobox field

Create a list of selectable dropdown options.

Field descriptions for combobox

  Field Function/Description
1 Required field Assign this field as mandatory
2 Graph Allows you to represent the results as a pie or bar graph in the Reporting tab
3 Validation message Message displayed to advise the respondent that they have not filled in this required field (if assigned)
4 Description Overview of field
5 Options Set up the drop down options by inserting 'Text' displayed on screen and the default 'Value' of the field. Tick 'Selected' if you want this item pre-selected by default. Click 'Add' to create more options. To delete use the settings drop down to the right of the field and to rearrange the options drag and drop them using the move item icon to the left of the field. 

Settings screen for combobox

Combobox display in live form

Checkbox and Checkbox Matrix fields

The Checkbox input type allows respondents to select multiple results from options using tick boxes. Settings are configured as per combobox

Checkbox display in live form

Note: Settings screen options are the same as the Combobox above.

Using the Checkbox field allows multiple results to a number of set questions, so the respondent can choose more than one options to answer the question.

Checkbox matrix

The most common use for Combobox Matrix is providing various ratings for the quality of a service or experience.

Settings screen for Checkbox matrix

Checkbox display in live form

RadioButton and Radio Matrix

The Radiobutton field works the same as the Combobox but only allows respondents to select one result from a group of options. The Edit field properties or settings are the same as Checkbox and Checkbox matrix.

Radiobutton display in live form

The Radiobox field option allows only one result for a number of set questions. The respondent can only choose one option to answer the question.

Radiobox matrix

The most common use for Radio Matrix is to provide definitive answers for the quality of a service or experience from preset options or levels.

The settings screen options are the same as the Checkbox Matrix.

Radiobutton matrix display in live form

Date field

The date field allows respondents to enter a single date from the calendar widget.

The settings for the Date field allows you to set this as a required field, and the date period available for the respondent to choose a single date from the calendar. If either are set make sure a validation message is used to explain these rules.

Settings screen for date field

Date display in live form

File upload field

The File uploader allows the respondent to add files to the form submission. In the settings, the file uploader can be assigned as a required field, the maximum file upload size and the specific file types permitted to be uploaded.

If any file is available for upload leave the filetype as is (with a * only). If you want to allocated a list of accepted file types, put the file type extension in the Filetype field and click 'Add' to include additional filetype if required.

Settings screen for assigning specific file types for upload


Allows the respondent to rank order to a list of options.

This option can be assigned as mandatory (requiring a validation message) and internal description. Options are configured in settings, and display with a number field beside it identifying, the options position number in the list. Fields can be dragged to different positions in the list if desired. The rank or position number can be changed by the respondent in the live environment.

Settings screen for rank field

Rank display in live form

Was this article helpful?
1 out of 1 found this helpful