The country column allows users to select a country from the list of available countries. Each value stores a two-letter ISO-2 country code and the country's name.

Via the API, the country column supports read, filter, update, and clear operations.

Column Type	Implementation Type	Supported Operations
`country`	`CountryValue`	Read: Yes Filter: Yes Update: Yes Clear: Yes

Queries

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

The country field returns a nested Country object with code and name subfields.

query {
  items(ids: [1234567890, 9876543210]) {
    name
    column_values {
      ... on CountryValue {
        id
        country {
          code
          name
        }
        text
        value
        updated_at
      }
    }
  }
}

const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      name
      column_values {
        ... on CountryValue {
          id
          country {
            code
            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 CountryValue implementation will return.

Field	Description	Supported Fields
column `Column!`	The column the value belongs to.
country `Country`	The selected country. Returns `null` if the column has no value.	code `String!` name `String!`
id `ID!`	The column's unique identifier.
text `String`	The column's value as text (e.g., `"United States"`). Returns `""` if the column has no value.
type `ColumnType!`	The column's type.
updated_at `Date`	The column's last updated date.
value `JSON`	The raw JSON-formatted column value. Returns `{"countryCode": "XX", "countryName": "..."}` with an additional `changed_at` timestamp after updates.

Example response

{
  "data": {
    "items": [
      {
        "name": "My item",
        "column_values": [
          {
            "id": "country",
            "country": {
              "code": "US",
              "name": "United States"
            },
            "text": "United States",
            "value": "{\"countryCode\":\"US\",\"countryName\":\"United States\"}",
            "updated_at": "2026-03-21T08:26:30.268Z"
          }
        ]
      }
    ]
  }
}

Filter

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

Operator	Compare Value	Description
`any_of`	An array of ISO-2 country codes (e.g., `["US", "DE"]`) or `[""]` for blank values	Returns items whose country matches any of the specified codes.
`not_any_of`	An array of ISO-2 country codes (e.g., `["US"]`) or `[""]` for blank values	Excludes items whose country matches any of the specified codes.
`is_empty`	`[]`	Returns items with no country value set.
`is_not_empty`	`[]`	Returns items that have a country value set.
`contains_text`	Partial or full country name (e.g., `"United"`)	Returns items whose country name contains the specified text.
`not_contains_text`	Partial or full country name (e.g., `"United"`)	Excludes items whose country name contains the specified text.

Examples

Filter by country code

This example returns all items whose country column matches Uruguay.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "country"
            compare_value: ["UY"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
        column_values {
          ... on CountryValue {
            country {
              code
              name
            }
          }
        }
      }
    }
  }
}

const query = `
  query ($boardId: [ID!], $columnId: ID!, $operator: ItemsQueryRuleOperator!, $compareValue: CompareValue!) {
    boards(ids: $boardId) {
      items_page(
        query_params: {
          rules: [
            { column_id: $columnId, compare_value: $compareValue, operator: $operator }
          ]
        }
      ) {
        items {
          id
          name
        }
      }
    }
  }
`;

const variables = {
  boardId: 1234567890,
  columnId: "country",
  compareValue: ["UY"],
  operator: "any_of",
};

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

Filter by country name

This example returns all items whose country name contains "United".

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

Filter by empty country

This example returns all items on the specified board with no country value set.

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

Mutations

Create column

Required scope: boards:write

You can create a country column using the generic create_column mutation. There is no typed create_country_column mutation.

mutation {
  create_column(
    board_id: 1234567890
    title: "Country"
    column_type: country
  ) {
    id
    title
    type
  }
}

Update value

You can update a country column using change_multiple_column_values. Pass a JSON object with countryCode (ISO-2 code) and countryName (full country name).

🚧
The change_simple_column_value mutation is not supported for the country column. You must use change_multiple_column_values.

`change_multiple_column_values`

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"country\": {\"countryCode\": \"US\", \"countryName\": \"United States\"}}"
  ) {
    id
  }
}

const query = `
  mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) {
    change_multiple_column_values(
      item_id: $itemId
      board_id: $boardId
      column_values: $columnValues
    ) {
      id
    }
  }
`;

const variables = {
  boardId: 1234567890,
  itemId: 9876543210,
  columnValues: JSON.stringify({
    country: {
      countryCode: "SG",
      countryName: "Singapore"
    }
  })
};

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

📘
Both countryCode and countryName are required. The code must be a valid two-letter ISO-2 abbreviation.

Set country on item creation

You can set a country value when creating an item by passing it in the column_values argument.

mutation {
  create_item(
    board_id: 1234567890
    item_name: "New item"
    column_values: "{\"country\": {\"countryCode\": \"JP\", \"countryName\": \"Japan\"}}"
  ) {
    id
    name
  }
}

Clear

You can clear a country column using change_multiple_column_values by passing null.

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"country\": null}"
  ) {
    id
  }
}

const query = `
  mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) {
    change_multiple_column_values(
      item_id: $itemId
      board_id: $boardId
      column_values: $columnValues
    ) {
      id
    }
  }
`;

const variables = {
  boardId: 1234567890,
  itemId: 9876543210,
  columnValues: JSON.stringify({
    country: null
  })
};

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

Reading column configuration

You can query the country column's settings through the column's settings field. The country column has no configurable settings, so settings returns an empty JSON object.

🚧
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: ["country"]) {
      id
      title
      type
      settings
    }
  }
}

Example response

{
  "data": {
    "boards": [
      {
        "columns": [
          {
            "id": "country",
            "title": "Country",
            "type": "country",
            "settings": {}
          }
        ]
      }
    ]
  }
}

Get column type schema

You can retrieve the JSON schema for the country 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: country
  )
}

{
  "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": {},
            "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.