Groups related blocks together. For standalone blocks, use the block's own uuid. For child blocks (e.g., dropdown options, multiple choice options), use the parent block's uuid so all children share the same groupUuid.
Payload for MATRIX_COLUMN block type. Used for matrix question columns.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tally Developer Docs","colors":{"primary":"#000","light":"#559BFA","dark":"#0170D7"},"logo":{"light":"https://mintcdn.com/tally/Lx32mG3X3piCKx5e/images/logo/light.svg?fit=max\u0026auto=format\u0026n=Lx32mG3X3piCKx5e\u0026q=85\u0026s=cd40b335ca868409ff942f2762879cae","dark":"https://mintcdn.com/tally/Lx32mG3X3piCKx5e/images/logo/dark.svg?fit=max\u0026auto=format\u0026n=Lx32mG3X3piCKx5e\u0026q=85\u0026s=2d26351e2ae668d00f3350d2f8154080"},"favicon":"https://mintcdn.com/tally/ZsljAhSrsTiaKklr/images/favicon.ico?fit=max\u0026auto=format\u0026n=ZsljAhSrsTiaKklr\u0026q=85\u0026s=0248d1609351a722b90aee3c7fbe8b3f","navbar":{"links":[{"href":"https://tally.so/support","label":"Support"},{"href":"https://tally.so/help","label":"Help Center"}],"primary":{"type":"button","label":"Create API key","href":"https://tally.so/settings/api-keys"}},"footer":{"socials":{"github":"https://github.com/tallyforms","x":"https://twitter.com/tallyforms","reddit":"https://www.reddit.com/r/tallyforms","linkedin":"https://linkedin.com/company/tallyforms","instagram":"https://instagram.com/tallyforms","bluesky":"https://bsky.app/profile/tally.so","threads":"https://threads.net/@tallyforms"}},"integrations":{"plausible":{"domain":"developers.tally.so"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tally","hasAudioNarration":false,"actualSubdomain":"tally","customDomains":["developers.tally.so"],"gitSource":{"type":"github","owner":"tallyforms","repo":"tally","deployBranch":"develop","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae30ade75b8bd33c16b0232","collectionId":"3ed126e3-3035-4b53-a273-f81779605cc4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae30ade75b8bd33c16b0232"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae30ade75b8bd33c16b0232","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":40},{"language":"default","tag":"Block Schema Reference","count":39},{"language":"default","tag":"Blocks","count":39},{"language":"default","tag":"Forms","count":14},{"language":"default","tag":"Workspaces","count":9},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Widgets","count":8},{"language":"default","tag":"Getting started","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Analytics","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"blocks-reference/matrix-column","slug":"/blocks-reference/matrix-column","pageMetadata":{"title":"Matrix column","openapi-schema":"MatrixColumnBlock","description":null,"href":"/blocks-reference/matrix-column"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Matrix column","openapi-schema":"MatrixColumnBlock","description":null,"href":"/blocks-reference/matrix-column"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"schemaData":{"type":"object","title":"MatrixColumnBlock","description":"A block with type MATRIX_COLUMN. Column within a matrix question.","properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for this block.","isRequired":true,"uniqueKey":"uuid","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["MATRIX_COLUMN"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"groupUuid":{"type":"string","format":"uuid","description":"Groups related blocks together. For standalone blocks, use the block's own uuid. For child blocks (e.g., dropdown options, multiple choice options), use the parent block's uuid so all children share the same groupUuid.","isRequired":true,"uniqueKey":"groupUuid","typeLabel":"string\u003cuuid>"},"groupType":{"type":"string","enum":["MATRIX"],"isRequired":true,"uniqueKey":"groupType","typeLabel":"enum\u003cstring>"},"payload":{"type":"object","title":"MatrixColumnPayload","description":"Payload for MATRIX_COLUMN block type. Used for matrix question columns.","required":["index","isFirst","isLast"],"properties":{"index":{"type":"number","description":"Position of this option within the group (0-indexed).","isRequired":true,"uniqueKey":"payload.index","typeLabel":"number"},"isFirst":{"type":"boolean","description":"True if this is the first option in the group.","isRequired":true,"uniqueKey":"payload.isFirst","typeLabel":"boolean"},"isLast":{"type":"boolean","description":"True if this is the last option in the group.","isRequired":true,"uniqueKey":"payload.isLast","typeLabel":"boolean"},"isHidden":{"type":"boolean","description":"When true, hides the field from respondents. Hidden fields don't appear on the form but can be shown via conditional logic.","uniqueKey":"payload.isHidden","typeLabel":"boolean"},"isRequired":{"type":"boolean","description":"When true, the field must be filled out before the form can be submitted. Respondents will see a required indicator.","uniqueKey":"payload.isRequired","typeLabel":"boolean"},"allowMultiple":{"type":"boolean","description":"True if respondents can select multiple columns per row.","uniqueKey":"payload.allowMultiple","typeLabel":"boolean"},"randomizeRows":{"type":"boolean","description":"True if the matrix rows are shown in random order.","uniqueKey":"payload.randomizeRows","typeLabel":"boolean"},"name":{"type":"string","description":"Optional identifier for this block. Can be used to reference the block in integrations or conditional logic.","uniqueKey":"payload.name","typeLabel":"string"},"html":{"type":"string","description":"Rich text content. Supports basic formatting: bold, italic, underline, links, and mentions.","uniqueKey":"payload.html","typeLabel":"string"},"text":{"type":"string","description":"Display text for this matrix column.","uniqueKey":"payload.text","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payload","typeLabel":"MatrixColumnPayload · object"}},"required":["uuid","type","groupUuid","groupType","payload"],"uniqueKey":"","typeLabel":"MatrixColumnBlock · object","example":{"title":"Example","value":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"MATRIX_COLUMN","groupUuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","groupType":"MATRIX","payload":{"index":123,"isFirst":true,"isLast":true,"isHidden":true,"isRequired":true,"allowMultiple":true,"randomizeRows":true,"name":"\u003cstring>","html":"\u003cstring>","text":"\u003cstring>"}}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"tally","siteName":"Tally Developer Docs","title":"Matrix column - Tally Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T08:59:19.607Z","originalFileLocation":"blocks-reference/matrix-column.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Tally Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Matrix column - Tally Developer Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tally Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.tally.so/blocks-reference/matrix-column\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tally.mintlify.app/_mintlify/api/og/v2?division=Blocks\u0026amp;title=Matrix+column\u0026amp;theme=debacae51ba8e2027e4df92a\u0026amp;signature=42b685ea1542be4c59f5e027d931dacd0f30a914e29cf0f14b3640146a711d4e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Matrix column - Tally Developer Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tally.mintlify.app/_mintlify/api/og/v2?division=Blocks\u0026amp;title=Matrix+column\u0026amp;theme=debacae51ba8e2027e4df92a\u0026amp;signature=42b685ea1542be4c59f5e027d931dacd0f30a914e29cf0f14b3640146a711d4e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tally/GwnFY1zAokn6LpcE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tally Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.tally.so/blocks-reference/matrix-column\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/blocks-reference/matrix-column.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.tally.so/#organization\",\"name\":\"Tally Developer Docs\",\"url\":\"https://developers.tally.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tally/Lx32mG3X3piCKx5e/images/logo/light.svg?fit=max\u0026auto=format\u0026n=Lx32mG3X3piCKx5e\u0026q=85\u0026s=cd40b335ca868409ff942f2762879cae\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.tally.so#website\",\"name\":\"Tally Developer Docs\",\"url\":\"https://developers.tally.so\",\"publisher\":{\"@id\":\"https://developers.tally.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.tally.so/blocks-reference/matrix-column#webpage\",\"url\":\"https://developers.tally.so/blocks-reference/matrix-column\",\"name\":\"Matrix column\",\"dateModified\":\"2026-10-29T08:59:19.607Z\",\"isPartOf\":{\"@id\":\"https://developers.tally.so#website\"},\"breadcrumb\":{\"@id\":\"https://developers.tally.so/blocks-reference/matrix-column#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.tally.so/blocks-reference/matrix-column#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Blocks\",\"item\":\"https://developers.tally.so/blocks-reference/form-title\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Matrix column\",\"item\":\"https://developers.tally.so/blocks-reference/matrix-column\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.tally.so/blocks-reference/matrix-column#apireference\",\"headline\":\"Matrix column\",\"name\":\"Matrix column\",\"url\":\"https://developers.tally.so/blocks-reference/matrix-column\",\"mainEntityOfPage\":{\"@id\":\"https://developers.tally.so/blocks-reference/matrix-column#webpage\"},\"dateModified\":\"2026-10-29T08:59:19.607Z\",\"publisher\":{\"@id\":\"https://developers.tally.so/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.tally.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tally Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tally Developer Docs","nav":{"global":null,"tabs":[{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Block Schema Reference","groups":[{"group":"Blocks","pages":[{"title":"Form title","href":"/blocks-reference/form-title"},{"title":"Text","href":"/blocks-reference/text"},{"title":"Label","href":"/blocks-reference/label"},{"title":"Title","href":"/blocks-reference/title"},{"title":"Heading 1","href":"/blocks-reference/heading1"},{"title":"Heading 2","href":"/blocks-reference/heading2"},{"title":"Heading 3","href":"/blocks-reference/heading3"},{"title":"Divider","href":"/blocks-reference/divider"},{"title":"Page break","href":"/blocks-reference/page-break"},{"title":"Image","href":"/blocks-reference/image"},{"title":"Embed","href":"/blocks-reference/embed"},{"title":"Embed video","href":"/blocks-reference/embed-video"},{"title":"Embed audio","href":"/blocks-reference/embed-audio"},{"title":"Matrix","href":"/blocks-reference/matrix"},{"title":"Input text","href":"/blocks-reference/input-text"},{"title":"Input number","href":"/blocks-reference/input-number"},{"title":"Input email","href":"/blocks-reference/input-email"},{"title":"Input link","href":"/blocks-reference/input-link"},{"title":"Input phone number","href":"/blocks-reference/input-phone-number"},{"title":"Input date","href":"/blocks-reference/input-date"},{"title":"Input time","href":"/blocks-reference/input-time"},{"title":"Textarea","href":"/blocks-reference/textarea"},{"title":"File upload","href":"/blocks-reference/file-upload"},{"title":"Linear scale","href":"/blocks-reference/linear-scale"},{"title":"Rating","href":"/blocks-reference/rating"},{"title":"Hidden fields","href":"/blocks-reference/hidden-fields"},{"title":"Multiple choice option","href":"/blocks-reference/multiple-choice-option"},{"title":"Checkbox","href":"/blocks-reference/checkbox"},{"title":"Dropdown option","href":"/blocks-reference/dropdown-option"},{"title":"Ranking option","href":"/blocks-reference/ranking-option"},{"title":"Multi select option","href":"/blocks-reference/multi-select-option"},{"title":"Payment","href":"/blocks-reference/payment"},{"title":"Signature","href":"/blocks-reference/signature"},{"title":"Matrix row","description":null,"href":"/blocks-reference/matrix-row"},{"title":"Matrix column","href":"/blocks-reference/matrix-column"},{"title":"Conditional logic","description":null,"href":"/blocks-reference/conditional-logic"},{"title":"Calculated fields","href":"/blocks-reference/calculated-fields"},{"title":"Captcha","href":"/blocks-reference/captcha"},{"title":"Respondent country","href":"/blocks-reference/respondent-country"}]}]},{"tab":"Widgets","pages":[{"title":"Widgets","href":"/widgets/introduction"}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/creating-a-form"}]}]},"basePath":"","title":"Matrix column - Tally Developer Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}