{"templateId":"@theme/Templates/SideBySide.tsx","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["split"]},"type":"markdown"},"seo":{"title":"Multiple selection","description":"Build integrations, automate workflows, and manage forms and responses programmatically with the forms.app API.","siteUrl":"https://developers.forms.app","image":"/assets/formsapp-developer-docs.6ffba4f5ff7d394698661bcdb0ed2a8452f27acaf4e82754e5d0f4109563471c.9c1bb791.png","lang":"en-US","projectTitle":"forms.app Developer Docs","llmstxt":{"sections":[{"title":"llmtxt for forms app documents","includeFiles":["**/*"],"excludeFiles":[]}]},"jsonLd":{"@context":"https://schema.org","@type":"Organization","additionalType":"https://en.wikipedia.org/wiki/Software_as_a_service","url":"https://forms.app","name":"forms.app","logo":"https://cdn.forms.app/icons/all/brands/formsapp-logo-dark.svg","description":"forms.app is a free online form builder designed for teams. forms.app offers a modern, easy-to-use form builder and allows unlimited responses and team members.","foundingDate":"2018","sameAs":"https://linkedin.com/company/formsapp","contactPoint":{"@type":"ContactPoint","contactType":"Customer service","email":"support@forms.app","url":"https://forms.app/en/contact-us"}}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"multiple-selection","__idx":0},"children":["Multiple selection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lets respondents choose more than one option from a list. Supports min/max selection limits, ordering, and default values."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://forms.app/en/help-center/multiple-selection"},"children":["Multiple Selection field"]}," help article for builder options."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"schema","__idx":1},"children":["Schema"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.subType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"multiplechoice\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Multi-select checkboxes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.options"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List of choices, each with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["text"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_id"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.min"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Minimum number of options that must be selected"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.max"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum number of options that can be selected"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.other"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show an \"Other\" option"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.defaultValue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string[]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pre-selected option IDs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.isOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserve the defined option order (disable shuffle)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["choice.shuffleOptions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Randomize option order for each visitor"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"_id\": \"6a0ef6b13affac35058b05ec\",\n  \"questionType\": \"choice\",\n  \"question\": \"Multiple choice question\",\n  \"displayOrder\": 7,\n  \"isRequired\": false,\n  \"isDeleted\": false,\n  \"isActive\": false,\n  \"description\": \"Multiple choice question helper text\",\n  \"choice\": {\n    \"subType\": \"multiplechoice\",\n    \"min\": 2,\n    \"max\": 3,\n    \"other\": false,\n    \"options\": [\n      { \"text\": \"Option 1\", \"_id\": \"6a0ef6b13affac35058b05ea\" },\n      { \"text\": \"Option 2\", \"_id\": \"6a0ef6cf3affac35058b0634\" },\n      { \"text\": \"Option 3\", \"_id\": \"6a0ef6d23affac35058b0635\" }\n    ],\n    \"defaultValue\": [\"6a0ef6cf3affac35058b0634\"],\n    \"isOrder\": true,\n    \"shuffleOptions\": false,\n    \"_id\": \"6a0ef771a7a40272efec2aac\"\n  }\n}\n","lang":"json"},"children":[]}]}]},"headings":[{"value":"Multiple selection","id":"multiple-selection","depth":1},{"value":"Schema","id":"schema","depth":2}],"frontmatter":{"template":"@theme/Templates/SideBySide.tsx","seo":{"title":"Multiple selection"}},"lastModified":"2026-05-21T13:45:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/form-schema/form-fields/multiple-selection","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}