Progress tracking

The progress tracking column combines all the status columns on a board into one column to visually track your progress. Our API does not support the progress tracking column, so you cannot read, update, or clear it via the API. You can, however, filter the column via the API.

Filtering the progress tracking column

Using the items_page object, you can easily filter a board's items by specific columns or column values. The table below contains the progress tracking column's supported operators and compare values.

OperatorsCompare values
any_of
  • 0 (items less than 20% done)
  • "20" (items more than 20% done)
  • "50" (items more than 50% done)
  • "80" (items more than 80% done)
  • "100" (items that are done)
  • "" (blank values)
  • not_any_of
  • 0 (items less than 20% done)
  • "20" (items more than 20% done)
  • "50" (items more than 50% done)
  • "80" (items more than 80% done)
  • "100" (items that are done)
  • "" (blank values)
  • 👍

    Pro tip

    items_page is only available in API version 2023-10 for now.

    The following example returns all items on the specified board that are more than 80% complete.

    query {
      boards (ids: 1234567890) {
        items_page (query_params: {rules: [{column_id: "progress", compare_value: ["80"], operator:any_of}]}) {
          items {
            id
            name
          }
        }
      }
    }
    

    📘

    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! 😎