Managed columns are useful tools to standardize workflows across your monday.com account. Select users can create, own, and manage status and dropdown columns with predefined labels that other members can't edit. This ensures consistent terminology across different workflows and helps align teams on a unified structure.

Queries

Get managed column

Returns an array containing metadata about one or several managed columns
Can only be queried directly at the root; can't be nested within another query

query {
  managed_column(state: active) {
    created_by
    revision
    settings {
      ...on StatusColumnSettings { 
        type
        labels {
          id
          description
        }
      }
    }
  }
}

Arguments

Argument	Type	Description	Enum Values
id	`[String!]`	The unique identifier of the managed column to filter by.
state	`[ManagedColumnState!]`	The state of the managed column to filter by.	`active` `inactive`

Fields

Field	Type	Description	Enum Values	Possible Types
created_at	`Date`	The managed column's creation date.
created_by	`ID`	The unique identifier of the user who created the managed column.
description	`String`	The managed column's description.
id	`String`	The unique identifier of the managed column.
revision	`Int`	The current version of the managed column.
settings	`ColumnSettings`	The managed column's settings.		`DropdownColumnSettings` `StatusColumnSettings`
settings_json	`JSON`	The managed column's settings in JSON.
state	`ManagedColumnState`	The managed column's state.	`active` `inactive`
title	`String`	The managed column's title.
updated_at	`Date`	The managed column's last updated date.
updated_by	`ID`	The unique identifier of the user who last updated the managed column.

Mutations

Create status managed column

Creates a new managed status column. Returns StatusManagedColumn.

mutation {
  create_status_managed_column(
    title: "Project status"
    description:"This column indicates the project's status."
    settings: {
      labels: [
        {
          color: done_green
          label: "Done"
          index: 1
          is_done: true
        },
        {			
          color: working_orange
          label: "In progress"
          index: 2
        },
        {			
          color: stuck_red
          label: "Stuck"
          index: 3
        }
      ]
    }
  ) {
    id
    state
    created_at
    created_by
  }
}

Arguments

Argument	Type	Description
description	`String`	The description of the new managed dropdown column.
settings	`CreateStatusColumnSettingsInput`	The settings of the new managed dropdown column.
title	`String!`	The title of the new managed dropdown column.

Create dropdown managed column

Creates a new managed dropdown column. Returns DropdownManagedColumn.

mutation {
  create_dropdown_managed_column(
    title: "Project Domains"
    description: "This column lists all of the domains the project falls under."
    settings: {
      labels: [
        {
          label: "Research and Development" 
        }, 
        { 
          label: "Human Resources" 
        }, 
        {
          label: "Customer Support"
        }
      ]
    }
  ) {
    id
    title
    state
    created_at
    created_by
    settings {
      labels {
        id
        label
        is_deactivated
      }
    }
  }
}

Arguments

Argument	Type	Description
description	`String`	The description of the new managed dropdown column.
settings	`CreateDropdownColumnSettingsInput`	The settings of the new managed dropdown column.
title	`String!`	The title of the new managed dropdown column.

Activate managed column

Activates a managed column. Returns ManagedColumn.

mutation {
  activate_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
	) {
    status
    title
  }
}

Arguments

Argument	Type	Description
id	`String!`	The unique identifier of the managed column to activate.

Attach dropdown managed column

Creates a new dropdown column that's linked to a managed column. The new column's settings and data are controlled by the managed column. Returns ManagedColumn.

mutation {
  attach_dropdown_managed_column(
    board_id: 1234567890
    managed_column_id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    title: "Project Domains"
    description: "This column is attached to a managed column."
    settings: {
      label_limit_count: 3
      limit_select:true
    }
  ) {
    id
    title
    type
  }
}

Arguments

Argument	Type	Description
after_column_id	`ID`	The unique identifier to insert the new column after.
board_id	`ID!`	The board's unique identifier.
description	`String`	The new dropdown column's description. If omitted, the description of the linked managed column will be used.
managed_column_id	`ID!`	The unique identifier of the managed column to attach.
settings	`DropdownSettingsOverridesInput`	The new dropdown column's optional settings.
title	`String`	The new dropdown column's title. If omitted, the title of the linked managed column will be used.

Attach status managed column

Creates a new status column that's linked to a managed column. The new column's settings and data are controlled by the managed column. Returns ManagedColumn.

mutation {
  attach_status_managed_column(
    board_id: 1234567890
    managed_column_id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    title: "Project Status"
    description: "This column is attached to a managed column."
  ) {
    id
    title
    type
  }
}

Arguments

Argument	Type	Description
after_column_id	`ID`	The unique identifier to insert the new column after.
board_id	`ID!`	The board's unique identifier.
description	`String`	The new status column's description. If omitted, the description of the linked managed column will be used.
managed_column_id	`ID!`	The unique identifier of the managed column to attach.
title	`String`	The new status column's title. If omitted, the title of the linked managed column will be used.

Update status managed column

Updates a managed status column. Returns ManagedColumn.

🚧 You must provide all of the column’s labels, even if you’re only updating one of them!

mutation {
  update_status_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    revision: 0
    title: "Project status"
    description:"This column indicates the status of the project."
    settings: {
      labels: [
        {
          color: bright_blue
          label: "In progress"
          index: 2
        }
      ]
    }
) {
  id
  description
  updated_at
  settings {
    labels {
      color
    }
  }
}

Arguments

Argument	Type	Description
description	`String`	The new description for the managed status column.
id	`String!`	The unique identifier of the managed status column to update.
revision	`Int!`	The current version of the managed column. Must be provided when updating the column to ensure your data is up to date. If you receive a revision error, the revision may be outdated — fetch the latest column data and try again.
settings	`UpdateStatusColumnSettingsInput`	The managed status column's settings to update.
title	`String`	The new title for the managed status column.

Update dropdown managed column

Updates a managed dropdown column. Returns ManagedColumn.

🚧 You must provide all of the column’s labels, even if you’re only updating one of them!

mutation {  
  update_dropdown_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
    revision: 0
    title: "Project Domains"
    description: "This column tracks each domain a project falls under."
    settings: {
      labels: [
        {
          id: 1
          label: "Research & Development"
        }
      ]
    }
  ) {
    description
    updated_at
    revision
    state
  }
}

Arguments

Argument	Type	Description
description	`String`	The updated description for the managed dropdown column.
id	`String!`	The unique identifier of the managed dropdown column to update.
revision	`Int!`	The current version of the managed column. Must be provided when updating the column to ensure your data is up to date. If you receive a revision error, the revision may be outdated — fetch the latest column data and try again.
settings	`UpdateDropdownColumnSettingsInput`	The managed dropdown column's settings to update.
title	`String`	The managed dropdown column's updated title.

Deactivate managed column

Deactivates a managed column. Returns ManagedColumn.

Deactivating a managed column prevents users from adding it to new boards. The column remains on existing boards and can be reactivated at any time using the activate_managed_column mutation or through the UI.

mutation {
  deactivate_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
  ) {
    state
    title
  }
}

Arguments

Argument	Type	Description
id	`String!`	The unique identifier of the managed column to deactivate.

Delete managed column

Deletes a managed column via the API. Returns ManagedColumn.

Deleting a managed column removes it from the Managed Column list in the Column Center and prevents users from adding it to new boards. The deleted column will remain on existing boards as a normal column, but it cannot be reactivated as a managed column.

mutation {
  delete_managed_column(
    id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
  ) {
    state
    title
  }
}

Arguments

Argument	Type	Description
id	`String!`	The unique identifier of the managed column to delete.