Rate this page:
With custom fields, you can add valuable information to a component that’s not available using Compass’s default fields. With custom fields, you can describe and classify a component in a way that’s relevant to your team’s needs.
You can create new custom fields to show them on selected component types. You can also edit a custom field’s details, and update its component types to choose which components the custom fields appear on.
A custom field type defines the type of data the field can contain. You must set a type for the custom field when you’re creating it. You can't change the type afterward.
A text field appears as a text box on a component and accepts plain text strings. People generally use the text field to convey descriptive details about the component.
Some examples of text custom fields are:
A checkbox field represents a component's property that can either be:
The custom field appears as a single checkbox on a component. It stores a boolean value depending on its selection state. Checkboxes are deselected (false) by default.
Some examples of checkbox custom fields are:
A number field accepts any integers and decimals. This is a numbers-only field. It appears as a single-line text box, where you can enter numbers as free-form text using numerical characters.
Some examples of number custom fields are:
A user field lets you search and choose one user from your Atlassian site. This person can be any user from your Atlassian site, irrespective of their access to Compass.
An example of using the user custom field is assigning a person with a particular role or responsibility towards the component, such as an architect or a product owner.
The user custom field isn't available to use with scorecards yet. We're working to add this feature soon.
Dropdown - Single select
A dropdown menu with multiple options appears on a component and accepts one selection. The options you can enter are plain text strings with a maximum character length of 80.
Dropdown - Multi-select
A dropdown menu with multiple options appears on a component and accepts up to 10 selections. The options you can enter are plain text strings with a maximum character length of 80. You can enter a maximum of 25 options via the UI, but you can add more options via the API.
The dropdown custom fields (single select and multi-select) aren't available to use with scorecards yet. We're working to add this feature soon.
You can create new custom fields from the Custom fields page in Compass settings.
You can have a maximum of 25 custom fields per Compass site.
Before creating a new custom field, check if:
To create a custom field:
To view all available custom fields:
To edit a custom field:
You can update the component types on an existing custom field to show or hide the custom field from specific component types. Updating component types work differently depending on the situation:
Add a component type for the first time — We’ll show the custom field on all components of the new component type you selected.
Remove a component type — We’ll hide the custom field from all components of the component type you deselected. We don't delete the custom field or its values from Compass. You can add the component type to the custom field to get the data back on those components.
Add a component type you'd removed earlier — We’ll show the previously hidden custom field again on all components of the component type you selected. Any custom field values that previously existed also appear again on those components.
When you add a component type to a custom field, it becomes available to add as a criterion on scorecards that match the component type. Learn more about using custom fields with scorecards
To show or hide a custom field on components:
If you delete a custom field, the field and its values will be permanently deleted from the Compass site. You can’t undo the deletion.
To delete a custom field:
Rate this page: