Files, signature and layout

Two question types collect a file, and two elements shape the form without collecting an answer. They share the common question keys.

type	Name in the editor	Answer type
file_upload	File	file_url
signature	Signature	file_url
statement	Statement	none
group	Grouped questions	none (its child questions answer)

file_upload

The respondent attaches one file or several files. The question is available in the Essential plan or higher.

Properties

Key	Type	Default	Description
description	string	""	Text under the question title.
allow_multiple_files	boolean	false	Allow multiple files. The respondent can attach more than one file.

Validations: required only.

Limits

The limits are not part of the form. They are the same for every form of a team.

Limit	Default
Size of one file	5 MB
Files per question, with allow_multiple_files	5
File types	jpg, jpeg, png, gif, tif, tiff, pdf, doc, docx, odt, rtf, txt, xls, xlsx, ods, csv, ppt, pptx, zip, rar, 7z, xml, mp3

A file over the size limit or of another type is rejected before it is uploaded, with a message to the respondent. Responsly support can change the limits for a team.

Answer

See File answers.

signature

A field where the respondent draws a signature with a finger, a stylus or the mouse. The drawing is saved as a PNG image.

It has no options of its own: properties.description and validations.required only. A new signature question starts with the title “Please sign below”.

Answer

The same format as a file upload with one file. See File answers.

statement

A text or an image between questions. It asks nothing, has no validations.required and is left out of question numbering.

Key	Type	Description
title	string	The statement text.
properties.description	string	Text under it.
media	object or false	Image or video. See Media.

A statement stores no answer.

group

Several questions on one page. Without groups, a form shows one question per page.

Key	Type	Description
components	array	The questions on the page, in order. Any question type except another group.
properties.description	string	Text shown above the questions, when set.
title	string	Not shown to respondents. Empty in a group made in the editor.

When question numbers are switched on, child questions are numbered inside the group: the second question of the third page is 3.2.

{
  "id": "Gd2fHs5JkL8z",
  "ref": "29eb03b5-8da1-4fc3-a142-9e1a3c5d7f80",
  "type": "group",
  "title": "",
  "properties": { "description": "" },
  "validations": { "required": false },
  "media": false,
  "components": [
    {
      "id": "Mx1cVb4NmQ7w",
      "ref": "3afc14c6-9eb2-40d4-b253-af2b4d6e8a91",
      "type": "text",
      "title": "First name",
      "properties": { "description": "", "multiple_lines": false },
      "validations": { "required": true },
      "media": false
    },
    {
      "id": "Er3tYu6IoP9a",
      "ref": "4b0d25d7-afc3-41e5-c364-b03c5e7f9ba2",
      "type": "mail",
      "title": "E-mail",
      "properties": { "description": "" },
      "validations": { "required": true },
      "media": false
    }
  ]
}

A group stores no answer of its own. Each child question stores its answer as it would outside a group, and logic rules, inserted values and responses refer to the child questions directly.