The button column allows you to perform an action (i.e., move an item to a new group) with just the click of a button. You can read the button column via the API, but you currently cannot filter, update, or clear it.

Reading the button column

You can query the button column using the column_values object that enables you to return column-specific subfields by sending a fragment in your query. Values for the button column are of the ButtonValue type.

query {
  items (ids:[1234567890, 9876543210]) {
    column_values {
      ... on ButtonValue {


color StringThe button's HEX color value.
column Column!The column the value belongs to.
id ID!The button column's unique identifier.
label String!The button's label.
text StringThe button's text.
type ColumnType!The column's type.
value JSONThe column's JSON-formatted raw value.


Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎