customized board columns

Question

customized board columns

Decker, Dave 0

so when you create customized board columns in the board view and map it to an existing state, I'm not able to pull those board columns into a query. It only shows the default values prior to the customized columns. How do I get my query to display that?

Pravallika KV 10,415 Reputation points Microsoft External Staff Moderator

2026-02-20T13:20:39.5966667+00:00
Hi @Decker, Dave,

Thanks for reaching out to Microsoft Q&A.

Here are a few things you can try to resolve this issue:

Ensure that your customized board columns are correctly mapped to the existing states. Each column should correspond to a category state (like Proposed, Committed, In Progress, Completed). You can find more details on how to customize and manage columns in your Azure Board here.

Check if your queries are set to display the correct fields and are querying for the associated states related to your custom columns. You might need to modify the queries to include the board column fields in the results. The Azure DevOps documentation on building queries can help you with that - check it out here.

Make sure that your work items are assigned to the correct backlog level associated with your team. If the work items are not reflected in the right backlog, they won't show in the customized columns. More about managing backlogs can be found here.

Ensure that no filters are applied to your query that may hide the results. Clear any existing filters and re-run your query to see if the custom columns appear.

If you’ve gone through these steps and are still having issues, consider checking if there are any overriding permissions or settings that could affect visibility.

Board permissions.

Hope this helps!
Decker, Dave 0 Reputation points

2026-02-20T13:23:57.82+00:00

Yep. Did all those things. At some point, I know the board column name (ones created) were showing up on the portfolio plan (the cards) and queries but now there are not showing up. So something has changed. But thanks, I had already trouble shot all the steps you outlined...still not displaying the correct board column
Decker, Dave 0 Reputation points

2026-02-20T13:33:08.78+00:00

I also reviewed the board permissions. It should affect ability to display the board column whether it is through a query or just showing up on the card (portfolio plan)
Pravallika KV 10,415 Reputation points Microsoft External Staff Moderator

2026-02-24T12:04:51.2766667+00:00

Hi Decker, Dave, following up to see if you had a chance to check the above suggestion and if it was helpful. Please let me know if you have any questions.

1 answer

Your answer

Pravallika KV 10,415 Reputation points Microsoft External Staff Moderator

2026-02-20T13:20:39.5966667+00:00

Hi @Decker, Dave,

Thanks for reaching out to Microsoft Q&A.

Here are a few things you can try to resolve this issue:

Ensure that your customized board columns are correctly mapped to the existing states. Each column should correspond to a category state (like Proposed, Committed, In Progress, Completed). You can find more details on how to customize and manage columns in your Azure Board here.

Check if your queries are set to display the correct fields and are querying for the associated states related to your custom columns. You might need to modify the queries to include the board column fields in the results. The Azure DevOps documentation on building queries can help you with that - check it out here.

Make sure that your work items are assigned to the correct backlog level associated with your team. If the work items are not reflected in the right backlog, they won't show in the customized columns. More about managing backlogs can be found here.

Ensure that no filters are applied to your query that may hide the results. Clear any existing filters and re-run your query to see if the custom columns appear.

If you’ve gone through these steps and are still having issues, consider checking if there are any overriding permissions or settings that could affect visibility.

Board permissions.

Hope this helps!
Decker, Dave 0 Reputation points

2026-02-20T13:23:57.82+00:00

Yep. Did all those things. At some point, I know the board column name (ones created) were showing up on the portfolio plan (the cards) and queries but now there are not showing up. So something has changed. But thanks, I had already trouble shot all the steps you outlined...still not displaying the correct board column
Decker, Dave 0 Reputation points

2026-02-20T13:33:08.78+00:00

I also reviewed the board permissions. It should affect ability to display the board column whether it is through a query or just showing up on the card (portfolio plan)
Pravallika KV 10,415 Reputation points Microsoft External Staff Moderator

2026-02-24T12:04:51.2766667+00:00

Hi Decker, Dave, following up to see if you had a chance to check the above suggestion and if it was helpful. Please let me know if you have any questions.

Answer 1

Pravallika KV 10,415 Microsoft External Staff Moderator

Hi @Decker, Dave, Board columns are just visual mappings to the State field: they are not real, queryable fields.

In Azure DevOps, board columns are essentially visual mappings to the underlying State field. Even if your new columns are correctly mapped, queries and reports only recognize the actual State values, not the column names.

To have it appear in a query:

Create new States in the process and map columns to those, or
Create a custom field and query that instead.

In the past, certain legacy behaviors may have allowed column names to appear in queries, but recent updates have tightened this: custom board columns mapped to existing States are no longer queryable as their column name.

Hope this helps!

If the resolution was helpful, kindly take a moment to click on User's image and click on Yes for was this answer helpful. And, if you have any further query do let us know.

Pravallika KV 10,415 Reputation points Microsoft External Staff Moderator

2026-02-27T13:00:03.4533333+00:00

The problem is that we are not able to display those board columns in any report and/or query

Hi @Decker, Dave, in Azure DevOps, board columns are essentially visual mappings to the underlying State field as I mentioned in the answer. Even if your new columns are correctly mapped, queries and reports only recognize the actual State values, not the column names.

In the past, certain legacy behaviors may have allowed column names to appear in queries, but recent updates have tightened this: custom board columns mapped to existing States are no longer queryable as their column name.
Pravallika KV 10,415 Reputation points Microsoft External Staff Moderator

2026-03-03T20:27:16.3733333+00:00

Hi @Decker, Dave, following up to see if you had a chance to check the above comment and if it was helpful.

Share via

customized board columns

1 answer

Your answer