The forms and reporting API allows you to create and edit forms as well as submit and export form data.
Forms are created from the admin portal using our drag and drop form editor. You can use up to 14 different widgets to create and structure your forms.
If you already have a form building tool (such as Wufoo) and want to automatically generate an equivalent form in your App, you may build a tool to create and publish a QuickSeries compatible form.
Below, you will see payload examples that you must follow in order to successfully create a form in your QuickSeries App.
I.e.:
{ "eid": "0045ffae-24bd-4e7d-bc33-1761817cebed", "title": "Example payload", "description": { "en": "<p>Example WYSIWYG description generated by Quill editor.</p>" }, "definition": "[{\"eid\":\"82e9c53c-b887-4f36-a98f-4d553f333c2f\",\"type\":\"section\",\"content\":[[{\"eid\":\"1760ac5d-5fde-4570-99c8-6c00616a3752\",\"type\":\"short-text-field\",\"label\":\"Short Text\",\"icon\":\"icon--short-text-field\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled short text\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"dsadasdasdas\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"placeholder\":{\"name\":\"Placeholder text\",\"value\":\"sadasdasdasd\",\"type\":\"text\",\"required\":false,\"info\":\"Enter example text to help users fill out this field. The text will disappear once users start typing.\"},\"defaultValue\":{\"name\":\"Default Value\",\"value\":\"dasdasd\",\"type\":\"default-text\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"},\"characterLimits\":{\"name\":\"Character Limits\",\"min\":3,\"max\":10,\"required\":true,\"type\":\"size-range\",\"info\":\"Enter the minimum and/or maximum number of characters allowed in this field.\"}},\"hasErrors\":[]}]],\"label\":\"Section\",\"icon\":\"icon--section\",\"allowedTypes\":[\"line-separator\",\"short-text-field\",\"long-text-field\",\"number-field\",\"file-upload\",\"dropdown-list\",\"multiple-choice\",\"single-choice\",\"address\",\"phone-number\",\"email-field\",\"date-picker\",\"time-picker\"],\"properties\":{\"title\":{\"name\":\"Section title\",\"value\":\"Untitled section\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a title for this element.\"},\"collapsible\":{\"name\":\"Section collapse\",\"value\":false,\"type\":\"checkbox\",\"required\":false,\"info\":\"Allow the user to collapse and expand this section.\"},\"description\":{\"name\":\"Instructions text\",\"value\":\"fefwefwefwe\",\"type\":\"textarea\",\"info\":\"Enter any notes or instructions to help users fill out this field.\",\"required\":false}},\"hasErrors\":[]},{\"eid\":\"cb31e0dd-357d-4a23-a30d-0e0ae24b79cb\",\"type\":\"long-text-field\",\"label\":\"Long Text\",\"icon\":\"icon--long-text-field\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Label\",\"value\":\"Untitled long text\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"efwfwe\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"placeholder\":{\"name\":\"Placeholder text\",\"value\":\"fefwefwef\",\"type\":\"text\",\"required\":false,\"info\":\"Enter example text to help users fill out this field. The text will disappear once users start typing.\"},\"defaultValue\":{\"name\":\"Default Value\",\"value\":\"fewfwef\",\"type\":\"default-textarea\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"},\"characterLimits\":{\"name\":\"Character Limits\",\"min\":1,\"max\":456,\"required\":true,\"type\":\"size-range\",\"info\":\"Enter the minimum and/or maximum number of characters allowed in this field.\"}},\"hasErrors\":[]},{\"eid\":\"39ef0e3d-5fbe-48a1-a649-b443f393dbe1\",\"type\":\"number-field\",\"label\":\"Number\",\"icon\":\"icon--number-input\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled number\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"dqwdqwdq\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"placeholder\":{\"name\":\"Placeholder text\",\"value\":\"dqwdqwdq\",\"type\":\"text\",\"required\":false,\"info\":\"Enter example text to help users fill out this field. The text will disappear once users start typing.\"},\"defaultValue\":{\"name\":\"Default Value\",\"value\":3,\"type\":\"default-number\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"},\"numberLimits\":{\"name\":\"Number range\",\"min\":1,\"max\":11,\"required\":true,\"type\":\"number-range\",\"info\":\"Enter the minimum and/or maximum number range required for this field.\"},\"unit\":{\"name\":\"Unit\",\"value\":\"meters\",\"type\":\"unit\",\"required\":true,\"info\":\"Enter the unit of measure required for this field. The unit will become part of the answer for users.\"}},\"hasErrors\":[]},{\"eid\":\"34186314-c9e1-4dd3-9d41-270b5c225e8a\",\"type\":\"file-upload\",\"label\":\"File Upload\",\"icon\":\"icon--file-upload\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled file\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"fwefwef\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"}},\"hasErrors\":[]},{\"eid\":\"21254c0d-c9ef-451e-b1a0-074332865512\",\"type\":\"dropdown-list\",\"label\":\"Dropdown\",\"icon\":\"icon--dropdown-list\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled dropdown\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"fwefwefw\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"defaultOptionValue\":{\"name\":\"Default Value\",\"value\":\"Option 2\",\"type\":\"default-option\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"},\"options\":{\"name\":\"Options\",\"value\":[{\"label\":\"Option 1\",\"value\":\"\"},{\"label\":\"Option 2\",\"value\":\"\"}],\"type\":\"options\",\"required\":true,\"info\":\"Create a list of options for users to choose from. Use the plus and minus to add or delete options.\"}},\"hasErrors\":[]},{\"eid\":\"5bce087d-f9ee-4597-8051-ef2a9bac330d\",\"type\":\"multiple-choice\",\"label\":\"Checklist\",\"icon\":\"icon--multiple-choice\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled checklist\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"fwefwef\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"defaultOptionsValues\":{\"name\":\"Default Values\",\"value\":[\"Option 2\"],\"type\":\"default-options\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"},\"options\":{\"name\":\"Options\",\"value\":[{\"label\":\"Option 1\",\"value\":\"\"},{\"label\":\"Option 2\",\"value\":\"\"}],\"type\":\"checkbox-group\",\"required\":true,\"info\":\"Enter each element to select from.\"}},\"hasErrors\":[]},{\"eid\":\"34bb8516-acf3-4c8f-85ee-4ec9433c3215\",\"type\":\"single-choice\",\"label\":\"Radio list\",\"icon\":\"icon--single-choice\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled single choice\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"fwefwe\",\"type\":\"textarea\",\"required\":false,\"info\":\"Use this field to provide the user with instructions for this field.\"},\"defaultOptionValue\":{\"name\":\"Default Value\",\"value\":\"Option 1\",\"type\":\"default-option\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"},\"options\":{\"name\":\"Options\",\"value\":[{\"label\":\"Option 1\",\"value\":\"\"},{\"label\":\"Option 2\",\"value\":\"\"}],\"type\":\"options\",\"required\":true,\"info\":\"Create a list of options for users to choose from. Use the plus and minus to add or delete options.\"}},\"hasErrors\":[]},{\"eid\":\"73cf153c-ab7c-416e-88ed-4c396be879a5\",\"type\":\"address\",\"label\":\"Address\",\"icon\":\"icon--address\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled address\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"fwefwef\",\"type\":\"textarea\",\"required\":false,\"info\":\"Use this field to provide the user with instructions for this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"}},\"hasErrors\":[]},{\"eid\":\"f38e6fe9-7c73-4e67-ae59-1402ecb6c4dd\",\"type\":\"phone-number\",\"label\":\"Phone\",\"icon\":\"icon--phone-number\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled phone\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"fwefwef\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"placeholder\":{\"name\":\"Placeholder text\",\"value\":\"12312321\",\"type\":\"text\",\"required\":false,\"info\":\"Enter example text to help users fill out this field. The text will disappear once users start typing.\"},\"defaultValue\":{\"name\":\"Default value\",\"value\":\"123123\",\"type\":\"default-phone\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"extension\":{\"name\":\"Extension\",\"value\":\"123\",\"type\":\"text\",\"required\":false,\"info\":\"Enter a extension field's default value.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Configure this field to be mandatory when the user submits this form.\"}},\"hasErrors\":[]},{\"eid\":\"01df11c1-14cd-4f7e-ac81-e5966d4e0c53\",\"type\":\"email-field\",\"label\":\"Email\",\"icon\":\"icon--email\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled email\",\"type\":\"text\",\"required\":true,\"info\":\"Enter a name or title for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"dqwdqwdq\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"placeholder\":{\"name\":\"Placeholder text\",\"value\":\"dqwdqwdq\",\"type\":\"text\",\"required\":false,\"info\":\"Enter example text to help users fill out this field. The text will disappear once users start typing.\"},\"defaultValue\":{\"name\":\"Default Value\",\"value\":\"email@domain.com\",\"type\":\"default-email\",\"required\":true,\"info\":\"Enter a default answer that will appear in this field.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Require users to fill out this field before they can submit the form.\"}},\"hasErrors\":[]},{\"eid\":\"8e11d52b-98ce-4f49-a3ec-a846dd9c6229\",\"type\":\"date-picker\",\"label\":\"Date\",\"icon\":\"icon--date-picker\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field label\",\"value\":\"Untitled date\",\"type\":\"text\",\"required\":true,\"info\":\"Add a label for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"dqwdqd\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"defaultValue\":{\"name\":\"Predefined Value\",\"value\":\"2022-03-17T04:00:00.000Z\",\"type\":\"default-date\",\"required\":true,\"info\":\"Add a default value for this field that the user will see and be able to change.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Prevent the user from submitting the form if this field is empty.\"},\"dateRange\":{\"name\":\"Date Range\",\"min\":\"2022-03-08T05:00:00.000Z\",\"max\":\"2022-03-31T04:00:00.000Z\",\"required\":true,\"type\":\"date-range\",\"info\":\"Select the date range that the user can choose from.\"}},\"hasErrors\":[]},{\"eid\":\"0908e23e-b606-4e1e-8af3-ff03dc9e4450\",\"type\":\"time-picker\",\"label\":\"Time\",\"icon\":\"icon--time-picker\",\"allowedTypes\":[],\"properties\":{\"label\":{\"name\":\"Field Label\",\"value\":\"Untitled time\",\"type\":\"text\",\"required\":true,\"info\":\"Add a label for this field.\"},\"instructions\":{\"name\":\"Instructions\",\"value\":\"dqwdqw\",\"type\":\"textarea\",\"required\":false,\"info\":\"Enter any notes or instructions to help users fill out this field.\"},\"defaultValue\":{\"name\":\"Predefined Value\",\"value\":\"16:19\",\"type\":\"default-time\",\"required\":true,\"info\":\"Add a default value for this field that the user will see and be able to change.\"},\"required\":{\"name\":\"Required field\",\"value\":true,\"type\":\"checkbox\",\"required\":false,\"info\":\"Prevent the user from submitting the form if this field is empty.\"},\"timeRange\":{\"name\":\"Time Range\",\"min\":\"08:00\",\"max\":\"17:00\",\"type\":\"time-range\",\"required\":true,\"meridian\":true,\"info\":\"Select the time range that the user can choose from.\"}},\"hasErrors\":[]}]", "status": "draft", "full_content": true, "updated_at": "2022-03-10T16:32:56.346Z", "notifications": ["portal.user@domain.com"] }
The definition key defined above is a “stringified” JSON that contains the definition/configuration of each form component. Below you will find the details about each definition keys.
(only the Line separator component should have a value of null here).
All properties contain UI logic for the form builder in our admin portal. If a property object is not passed, a default value for each property will be used, if a property object is passed, see the table below to check what is required when creating a new form from the API.
Here is a list of all properties and which component they belong to and whether they are required or optional:
properties.label
The label property represents the main component label.
properties.instructions
The instructions property represents text below the main component label.
properties.placeholder
The placeholder property represents placeholder text displayed in some components.
properties.defaultValue
The defaultValue property represents the default value that should be entered by default when a user loads the form. Unless changed by the user, it should be submitted as is to the API.
properties.required
The required property is used to validate whether a form component should have a value before submitting the form.
properties.characterLimits
The characterLimits property is used to set a character limits (min and max) for some components.
properties.numberLimits
The characterLimits property is used to set number limits (min and max) on the number component.
properties.unit
The unit property is used to append a unit of measure to the number entered in the number component.
properties.title
The title property is used to give a title to a section component.
properties.collapsible
The collapsible property is used to determine whether a section should be collapsible or not.
properties.description
The description property is text that appears below the section title.
properties.defaultOptionValue
The defaultOptionValue property is the default selected value for dropdown and radio list components. You must provide a value defined in the options definition.
properties.defaultOptionsValues
The defaultOptionsValues property is the default selected value(s) for checklist components. You must provide one or more values defined in the options definition.
properties.options
The options property defines all options you can select from in the dropdown, radio list and checklist components.
properties.extensions
The extensions property defines whether a phone extension field should be displayed.
properties.dateRange
The dateRange property defines the range within which the user can select a date.
properties.timeRange
The timeRange property defines the range within which the user can select a time.
The short text widget is a simple text input. You can configure that input with a label, instructions, a placeholder, a default value, whether it should be a required field or not and the character length limitation.
{ "eid": "1760ac5d-5fde-4570-99c8-6c00616a3752", "type": "short-text-field", "label": "Short Text", "icon": "icon--short-text-field", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example short text label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example short text instructions.", "type": "textarea", "required": false, "info": "Enter any notes or instructions to help users fill out this field." }, "placeholder": { "name": "Placeholder text", "value": "Example short text placeholder", "type": "text", "required": false, "info": "Enter example text to help users fill out this field. The text will disappear once users start typing." }, "defaultValue": { "name": "Default Value", "value": "Example short text default value.", "type": "default-text", "required": true, "info": "Enter a default answer that will appear in this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." }, "characterLimits": { "name": "Character Limits", "min": 3, "max": 10, "required": true, "type": "size-range", "info": "Enter the minimum and/or maximum number of characters allowed in this field." } }, "hasErrors": [] }
Long text definition example
The long text widget is a simple text box (or text area). You can configure that input with a label, instructions, a placeholder, a default value, whether it should be a required field or not and the character length limitation.
{ "eid": "cb31e0dd-357d-4a23-a30d-0e0ae24b79cb", "type": "long-text-field", "label": "Long Text", "icon": "icon--long-text-field", "allowedTypes": [], "properties": { "label": { "name": "Label", "value": "Example long text label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example long text instructions.", "type": "textarea", "required": false, "info": "Enter any notes or instructions to help users fill out this field." }, "placeholder": { "name": "Placeholder text", "value": "Example long text placeholder", "type": "text", "required": false, "info": "Enter example text to help users fill out this field. The text will disappear once users start typing." }, "defaultValue": { "name": "Default Value", "value": "Example long text default value.", "type": "default-textarea", "required": true, "info": "Enter a default answer that will appear in this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." }, "characterLimits": { "name": "Character Limits", "min": 1, "max": 456, "required": true, "type": "size-range", "info": "Enter the minimum and/or maximum number of characters allowed in this field." } }, "hasErrors": [] }
The number widget is a simple number input. You can configure that input with a label, instructions, a placeholder, a default value, whether it should be a required field or not, the number range the user must enter and a unit label.
{ "eid": "39ef0e3d-5fbe-48a1-a649-b443f393dbe1", "type": "number-field", "label": "Number", "icon": "icon--number-input", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example number field label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example number field instructions", "type": "textarea", "required": false, "info": "Enter any notes or instructions to help users fill out this field." }, "placeholder": { "name": "Placeholder text", "value": "Example number field placeholder", "type": "text", "required": false, "info": "Enter example text to help users fill out this field. The text will disappear once users start typing." }, "defaultValue": { "name": "Default Value", "value": 12345, "type": "default-number", "required": true, "info": "Enter a default answer that will appear in this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." }, "numberLimits": { "name": "Number range", "min": 1, "max": 1000, "required": true, "type": "number-range", "info": "Enter the minimum and/or maximum number range required for this field." }, "unit": { "name": "Unit", "value": "meters", "type": "unit", "required": true, "info": "Enter the unit of measure required for this field. The unit will become part of the answer for users." } }, "hasErrors": [] }
The file upload widget allows users to attach a single file to a form. You can configure that input with a label, instructions and whether it should be a required field or not.
{ "eid": "34186314-c9e1-4dd3-9d41-270b5c225e8a", "type": "file-upload", "label": "File Upload", "icon": "icon--file-upload", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example file upload label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example file upload instructions", "type": "textarea", "required": false, "info": "Enter any notes or instructions to help users fill out this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." } }, "hasErrors": [] }
The section widget allows you to group widgets together. You can configure that widget with a title, description, and whether it should be collapsible or not.
{ "eid": "0045ffae-24bd-4e7d-bc33-1761817cebed", "type": "section", "content": [ [ { "eid": "1760ac5d-5fde-4570-99c8-6c00616a3752", "type": "short-text-field", // ... } ] ], "label": "Section", "icon": "icon--section", "allowedTypes": [ "line-separator", "short-text-field", "long-text-field", "number-field", "file-upload", "dropdown-list", "multiple-choice", "single-choice", "address", "phone-number", "email-field", "date-picker", "time-picker" ], "properties": { "title": { "name": "Section title", "value": "Example section title", "type": "text", "required": true, "info": "Enter a title for this element." }, "collapsible": { "name": "Section collapse", "value": false, "type": "checkbox", "required": false, "info": "Allow the user to collapse and expand this section." }, "description": { "name": "Instructions text", "value": "Example section instructions", "type": "textarea", "info": "Enter any notes or instructions to help users fill out this field.", "required": false } }, "hasErrors": [] }
The line separator widget is a simple visual separator. It does not have any properties.
{ "eid": "51e88232-bf8f-4a2c-9462-eea24d1115b5", "type": "line-separator", "label": "Line", "icon": "icon--line-separator", "allowedTypes": [], "properties": null, "hasErrors": [] }
You can configure the dropdown widget with a label, instructions, a default value, whether it should be a required field and any number of unique options.
{ "eid": "21254c0d-c9ef-451e-b1a0-074332865512", "type": "dropdown-list", "label": "Dropdown", "icon": "icon--dropdown-list", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example dropdown label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example dropdown instructions", "type": "textarea", "required": false, "info": "Enter any notes or instructions to help users fill out this field." }, "defaultOptionValue": { "name": "Default Value", "value": "Option 2", "type": "default-option", "required": true, "info": "Enter a default answer that will appear in this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." }, "options": { "name": "Options", "value": [ { "label": "Option 1", "value": "" }, { "label": "Option 2", "value": "" } ], "type": "options", "required": true, "info": "Create a list of options for users to choose from. Use the plus and minus to add or delete options." } }, "hasErrors": [] }
You can configure the checklist widget with a label, instructions, a default value, whether it should be a required field and any number of unique options.
{ "eid": "5bce087d-f9ee-4597-8051-ef2a9bac330d", "type": "multiple-choice", "label": "Checklist", "icon": "icon--multiple-choice", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example checklist label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example checklist instructions", "type": "textarea", "required": false, "info": "Enter any notes or instructions to help users fill out this field." }, "defaultOptionsValues": { "name": "Default Values", "value": ["Option 2"], "type": "default-options", "required": true, "info": "Enter a default answer that will appear in this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." }, "options": { "name": "Options", "value": [ { "label": "Option 1", "value": "" }, { "label": "Option 2", "value": "" } ], "type": "checkbox-group", "required": true, "info": "Enter each element to select from." } }, "hasErrors": [] }
You can configure the radio list widget with a label, instructions, a default value, whether it should be a required field and any number of unique options.
{ "eid": "34bb8516-acf3-4c8f-85ee-4ec9433c3215", "type": "single-choice", "label": "Radio list", "icon": "icon--single-choice", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example single choice label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example single choice instructions", "type": "textarea", "required": false, "info": "Use this field to provide the user with instructions for this field." }, "defaultOptionValue": { "name": "Default Value", "value": "Option 1", "type": "default-option", "required": true, "info": "Enter a default answer that will appear in this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." }, "options": { "name": "Options", "value": [ { "label": "Option 1", "value": "" }, { "label": "Option 2", "value": "" } ], "type": "options", "required": true, "info": "Create a list of options for users to choose from. Use the plus and minus to add or delete options." } }, "hasErrors": [] }
You can configure the address widget with a label, instructions, and whether it should be a required field.
{ "eid": "73cf153c-ab7c-416e-88ed-4c396be879a5", "type": "address", "label": "Address", "icon": "icon--address", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example address label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example address instructions", "type": "textarea", "required": false, "info": "Use this field to provide the user with instructions for this field." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Require users to fill out this field before they can submit the form." } }, "hasErrors": [] }
You can configure the phone widget with a label, instructions, a placeholder, a default value, an extension value and whether it should be a required field.
{ "eid": "f38e6fe9-7c73-4e67-ae59-1402ecb6c4dd", "type": "phone-number", "label": "Phone", "icon": "icon--phone-number", "allowedTypes": [], "properties": { "label": { "name": "Field label", "value": "Example phone number label", "type": "text", "required": true, "info": "Enter a name or title for this field." }, "instructions": { "name": "Instructions", "value": "Example phone number instructions", "type": "textarea", "required": false, "info": "Enter any notes or instructions to help users fill out this field." }, "placeholder": { "name": "Placeholder text", "value": "(123) 456-7890", "type": "text", "required": false, "info": "Enter example text to help users fill out this field. The text will disappear once users start typing." }, "defaultValue": { "name": "Default value", "value": "18882345698", "type": "default-phone", "required": true, "info": "Enter a default answer that will appear in this field." }, "extension": { "name": "Extension", "value": "123", "type": "text", "required": false, "info": "Enter a extension field's default value." }, "required": { "name": "Required field", "value": true, "type": "checkbox", "required": false, "info": "Configure this field to be mandatory when the user submits this form." } }, "hasErrors": [] }
You can configure the email widget with a label, instructions, a placeholder, a default value and whether it should be a required field.
