> ## Documentation Index
> Fetch the complete documentation index at: https://fillout.com/help/llms.txt
> Use this file to discover all available pages before exploring further.

# Choice matrix

> Collect a grid or table of selections from respondents, matching corresponding rows and columns with radio buttons or checkboxes.

export const SupportBanner = () => {
  const titleId = React.useId();
  return <div className="support-banner" role="region" aria-labelledby={titleId}>
      <span className="support-banner__ring support-banner__ring--outer" aria-hidden="true" />
      <span className="support-banner__ring support-banner__ring--middle" aria-hidden="true" />
      <span className="support-banner__ring support-banner__ring--inner" aria-hidden="true" />
      <span className="support-banner__ring support-banner__ring--center" aria-hidden="true" />

      <div className="support-banner__content">
        <div className="support-banner__title" id={titleId} role="heading" aria-level="2">Still have questions?</div>

        <div className="support-banner__copy">
          <span className="support-banner__line">Our team is happy to help. Start a live chat using the</span>
          <span className="support-banner__line">
            chat bubble <span className="support-banner__chat-icon" aria-hidden="true" /> in the bottom right, or email us at
          </span>
          <span className="support-banner__line">
            <a href="mailto:support@fillout.com">support{'@'}fillout.com</a>
          </span>
        </div>

        <a className="support-banner__cta" href="mailto:support@fillout.com">Contact us</a>
      </div>
    </div>;
};

## Overview

The **choice matrix** field type can be used to collect data organized in a grid or table, where users need to select one or multiple options per row. Common use cases include:

* Selecting dates and corresponding slots or appointment times
* Ranking multiple options in a grid on a likert scale (e.g., unlikely to likely)
* Compare several products or features across multiple dimensions (e.g., performance, cost, reliability)

## How to put a choice matrix

<Steps>
  <Step title="Add a choice matrix field">
    Simply drag and drop the `Choice matrix` field from the left-hand panel.

    <img src="https://mintcdn.com/fillout-005a867b/VlJGYL0Tmi6U9cNr/images/Screenshot2025-10-06at5.17.33PM.png?fit=max&auto=format&n=VlJGYL0Tmi6U9cNr&q=85&s=2b7f9a4c27d694cda710ee3bfc7ba9a0" alt="Screenshot 2025-10-06 at 5.17.33 PM.png" width="2748" height="1436" data-path="images/Screenshot2025-10-06at5.17.33PM.png" />
  </Step>

  <Step title="Add titles for the rows and columns">
    The rows of your matrix will typically define the options or questions you want to have choices chosen for. In the example above, we’ve added item categories for the rows, and frequencies as the columns.
  </Step>

  <Step title="Turn radio buttons into checkboxes (Optional)">
    You can configure the choice matrix to allow single or multiple selections. Click the choice matrix followed by its <Icon icon="gear-complex" iconType="solid" />, and toggle `Can select multiple?` in the right-hand panel.

    <img src="https://mintcdn.com/fillout-005a867b/CKiuqsV2M8JgNFaD/images/images/image-13.png?fit=max&auto=format&n=CKiuqsV2M8JgNFaD&q=85&s=56119c0427b3db0b7a9b541bff4c53c7" alt="Screenshot of the Form designer tab of a form" style={{ width:"48%" }} width="503" height="550" data-path="images/images/image-13.png" />

    <Info>
      For single questions that may have multiple answers, use checkboxes, a multi-select or a picture choice field. More info [**here**](https://www.fillout.com/help/multiple-option-answers).
    </Info>
  </Step>
</Steps>

## Connect a choice matrix to integrations

When integrating the choice matrix (e.g., with Airtable, Notion, or HubSpot), you can map each row to different fields or properties separately.

<Steps>
  <Step title="Select an integration">
    Click `Integrate` in the top menu and choose Airtable, Notion or another [integration](/help/integrations).
  </Step>

  <Step title="Add a Choice matrix field">
    Click `Edit` in the top menu. In the left-hand panel under **Other**, click `Choice matrix`.
  </Step>

  <Step title="Map fields">
    Go back to the `Integrate` page. Under **Mappings**, look for the question followed by a row in your choice matrix to the fields in your chosen integration. Repeat this process for any other rows you need to send to your integration.

    <img src="https://mintcdn.com/fillout-005a867b/CKiuqsV2M8JgNFaD/images/images/image-14.png?fit=max&auto=format&n=CKiuqsV2M8JgNFaD&q=85&s=f445f695e97b4d1ea57ebc18442ae610" alt="Screenshot of the Form designer tab of a form" style={{ width:"97%" }} width="2065" height="766" data-path="images/images/image-14.png" />

    <Warning>
      If your choice matrix is set to **select** **multiple**, you should make sure to pick a property/field in your integration which allows multiple selections.
    </Warning>
  </Step>
</Steps>

## Related articles

<CardGroup cols={3}>
  <Card title="Enable multiselect" icon="list-check" iconType="regular" color="#FFC738" href="/help/multiple-option-answers">
    Create choice questions that support multiple answers.
  </Card>

  <Card title="Add a table" icon="table-cells" iconType="regular" color="#FFC738" href="/help/table">
    Let respondents enter data in a spreadsheet-like format.
  </Card>
</CardGroup>

<SupportBanner />
