Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Multi-select values fail to be loaded from compass.yaml

martin.wirth
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
September 8, 2025

Hi,

we're having problems with this piece of the documentation at https://developer.atlassian.com/cloud/compass/config-as-code/structure-and-contents-of-a-compass-yml-file/

> For single_select and multi_select fields, you can also refer to their displayValue instead of their value. This display value must exactly match the text value of that option.

We use display values and we are getting the attached error.

Can you advise, please?

Thank you!

 

1 answer

0 votes
Enrique Serrano Valle
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
September 8, 2025

Hi, @martin.wirth !

It doesn't look like the error that you intended to attach was included, and without seeing it, it's complicated to determine what could be happening in your specific situation.

Other than that, the instructions in the linked document make sense to me, understanding that:

  • The component that you're managing with config-as-code needs to be eligible for the custom field type that you're adding there
  • The component custom field name provided has to exactly match (case-sensitive) the name of the custom field in its definition (under Settings > Custom Fields > Custom field)
  • And the display name of the desired option provided has to exactly match (case-sensitive) the name of the custom field option in its definition (under Settings > Custom Fields > Custom field > Actions > Edit > Options)

Multi selects take an array of display values (in YAML, either an array, or a child indented list of items), while single selects take a single value.

For example, after defining a custom field named "Test multi select", that applies to all Service-type components and that has a possible option with display value "Option one", I can use the following compass.yml snippet to be applied:

typeId: SERVICE
...
customFields:
- name: 'Test multi select'
type: multi_select
displayValue:
- 'Option one'

 

Suggest an answer

Log in or Sign up to answer
TAGS
AUG Leaders

Atlassian Community Events