The vote column allows board subscribers and team members to vote on items. Votes are cast through the monday.com UI — the API provides read-only access to vote data and supports filtering.

Via the API, the vote column supports read and filter operations.

Column Type	Implementation Type	Supported Operations
`vote`	`VoteValue`	Read: Yes Filter: Yes Create column: Yes Update: No Clear: No

Queries

Vote columns can be queried through the column_values field on items queries using an inline fragment on VoteValue.

query {
  items(ids: [1234567890, 9876543210]) {
    name
    column_values {
      ... on VoteValue {
        id
        vote_count
        voter_ids
        voters {
          id
          name
        }
        text
        value
        updated_at
      }
    }
  }
}

const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      name
      column_values {
        ... on VoteValue {
          id
          vote_count
          voter_ids
          voters {
            id
            name
          }
          text
          value
          updated_at
        }
      }
    }
  }
`;

const variables = { itemIds: [1234567890, 9876543210] };

const response = await mondayApiClient.request(query, variables);

Fields

You can use the following fields to specify what information your VoteValue implementation will return.

Field	Description
column `Column!`	The column the value belongs to.
id `ID!`	The column's unique identifier.
text `String`	The column's value as text. Returns the vote count as a string (e.g., `"3"`). Returns `"0"` if no votes.
type `ColumnType!`	The column's type (`vote`).
updated_at `Date`	The column's last updated date. Returns `null` if the column has no votes.
value `JSON`	The column's JSON-formatted raw value. Returns `null` when there are no votes.
vote_count `Int!`	The total number of votes on the item.
voter_ids `[ID!]!`	The unique identifiers of users who voted.
voters `[User!]!`	The users who voted. Returns full user objects including `id`, `name`, `email`, etc.

Example response

{
  "data": {
    "items": [
      {
        "name": "Feature request",
        "column_values": [
          {
            "id": "vote",
            "vote_count": 3,
            "voter_ids": ["12345", "67890", "11111"],
            "voters": [
              { "id": "12345", "name": "Alice" },
              { "id": "67890", "name": "Bob" },
              { "id": "11111", "name": "Charlie" }
            ],
            "text": "3",
            "value": "{\"voter_ids\":[12345,67890,11111],\"changed_at\":\"2026-03-21T10:00:00.000Z\"}",
            "updated_at": "2026-03-21T10:00:00Z"
          }
        ]
      }
    ]
  }
}

📘
When a vote column has no votes, vote_count returns 0, voter_ids and voters return empty arrays, text returns "0", and both value and updated_at return null.

Filter

You can filter items by vote values using the items_page object. The vote column supports the following operators:

Operator	Compare Value	Description
`any_of`	An array of user IDs (e.g., `[12345]`) or `["No votes"]`	Returns items where any of the specified users voted, or items with no votes when `"No votes"` is passed.
`not_any_of`	An array of user IDs (e.g., `[12345]`) or `["No votes"]`	Excludes items where any of the specified users voted, or excludes items with no votes when `"No votes"` is passed.
`is_empty`	`[]`	Returns items with no votes.
`is_not_empty`	`[]`	Returns items that have at least one vote.

Examples

Filter by voter

The following example returns all items that user 12345 voted for.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "vote"
            compare_value: [12345]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
        column_values {
          ... on VoteValue {
            vote_count
            voter_ids
          }
        }
      }
    }
  }
}

Filter for items with no votes

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "vote"
            compare_value: ["No votes"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Filter for items with any votes

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "vote"
            compare_value: []
            operator: is_not_empty
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Mutations

Create column

Required scope: boards:write

You can create a vote column using the generic create_column mutation. There is no typed create_vote_column mutation.

mutation {
  create_column(
    board_id: 1234567890
    column_type: vote
    title: "Feature Votes"
    description: "Vote on features you want prioritized."
  ) {
    id
    title
    description
  }
}

You can optionally pass a custom display color in the defaults argument:

mutation {
  create_column(
    board_id: 1234567890
    column_type: vote
    title: "Feature Votes"
    defaults: "{\"settings\":{\"color\":\"#ff642e\"}}"
  ) {
    id
    title
    settings
  }
}

Update value

🚧
The vote column does not support updating values via the API. Votes can only be cast through the monday.com UI. Attempting to use change_simple_column_value will return an error: "column type VotesColumn is not supporting changing the column value with simple column value". The change_multiple_column_values mutation accepts the request and modifies the raw value JSON, but does not affect the actual vote fields (vote_count, voter_ids, voters).

Clear value

The vote column does not support clearing values via the API.

Reading column configuration

To retrieve a vote column's display color setting, query the column's settings field.

🚧
The settings_str field is deprecated as of API version 2025-10. Use the typed settings object instead, which returns structured JSON rather than a JSON-encoded string.

query {
  boards(ids: 1234567890) {
    columns(ids: ["vote"]) {
      id
      title
      settings
    }
  }
}

`settings` response structure

The settings field returns a typed JSON object with these keys:

Key	Type	Description
`color`	`string`	Hex color code for the vote column display (e.g., `"#ff642e"`). Only present if a custom color is set.

Example `settings` response

When no custom color is set:

{}

When a custom color is configured:

{
  "color": "#ff642e"
}

Get column type schema

You can retrieve the JSON schema for the vote column's settings programmatically using the get_column_type_schema query. This returns the structure, validation rules, and available properties for the column's configuration.

query {
  get_column_type_schema(
    type: vote
  )
}

{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {
              "color": {
                "type": "string",
                "description": "Hex color code for the votes column display (e.g., #fdab3d)",
                "minLength": 7,
                "maxLength": 7
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  }
}

The response includes property names, types, constraints (such as max lengths and allowed values), and descriptions for each setting. You can use this to validate column settings, dynamically generate UIs, or give context to AI agents. Learn more about the schema response format.