JetBrains Space Help

Add and Edit Custom Fields

The Profile, Absence, Team membership, and Team pages and forms contain default fields for entering and displaying relevant records (e.g. First Name in profiles and Period in absences).

If your organzation needs to collect or display more information, you can create additional fields. There can be numerous use cases depending on your organization demands. For example, you can add a custom field to member profiles to store information about member's personal interests. A custom field on Team pages can be used to provide links to external resources. A custom field on a Team membership form can store member's part-time participation information.

Custom fields come in many types, such as Text, List, Date, and allow for different data formats and input validation.

Create custom fields

  1. On the navigation bar, click administration.png Administration and choose Custom Fields from the sidebar.

  2. Select where you want to place a custom field:

    customFields.png
    • Memberships — a field will be added to a team membership form for each member.

    • Member profile — a field will added to each member profile. In profiles, a custom field can be made hidden (displayed to profile owner and/or authorized members only).

    • Absence — a field will added to each member absence form.

    • Teams- a field will added to each team's page.

  3. Click the New field button and fill out the form:

    customFieldsNewField.png
  4. Enter the Field name and select its Type. The settings and options will depend on the type you choose. For a detailed description of each setting, see Custom field settings.

  5. If you are creating a field for member profiles, select Access level: choose who will be able to see this field and the data it contains.

    • Public — every organization member

    • Confidential — profles owners and authorized members only (Requires permission: View confidential custom fields)

    • Restricted — authorized members only (Requires permission: View restricted custom fields)

  6. Use the interactive Live preview at the bottom to see and test your custom field.

  7. When you're done, click Create. The new custom field will be added to the pages/forms you selected.

Edit, archive, delete custom fields

  1. On the navigation bar, click administration.png Administration and choose Custom Fields from the sidebar.

  2. Go to the tab that corresponds to the location of the custom field you want to edit (Memberships, Member profiles, Absences, Teams)

    Existing custom fields, if any, will be listed here:

    customFieldsExisting.png

To edit a custom field:

  1. On the custom field list, locate the field you want to edit and click edit next to it.

  2. Refer to the custom fields settings and types descriptions to edit the settings.

To archive or delete a custom field:

  • On the custom field list, locate the field you want to archive or delete, click ... next to the field and choose a corresponding option:

    customFieldArchiveDelete.png

Custom field types

TypeDescription
TextCan be used to enter and store a short text (string of alphanumeric characters)
NumberCan store integers only.
ListA selection of predefined values (list items) that users can choose from (or add their own if the Open-ended option is enabled)
CheckboxA checkbox can be used for any binary input. For example, you can provide some question in its description, and the users can answer 'yes' by selecting the checkbox.
DateStores a single value in a date format. Users set and change the value by picking a date from a calendar popup.
Date and TimeStores a single value in a date/time format. Users set and change the value by picking a date and time from a calendar popup.
PercentageStores a single integer value (from 0 to 100 by default) and visualizes it with a progress bar.
Organization memberStores a reference to a member profile. Users can pick a member from a drop-down list.
TeamStores a reference to one of the teams in your organization. Users can pick a team from a drop-down list.
LocationStores a reference to one of the locations defined in your organizaton. Users can pick a location from a drop-down list.
ProjectStores a reference to one of the projects in your organizaton. Users can pick a project from a drop-down list.
LinkCan be used to provide and store a link to an internal or external resource.
IssueCan be used to store a link to an issue. To enter a reference to an issue, users should copy the issue ID link on the issue page and paste it into the field.

Custom field settings

Common settings. The following settings are available for all field types:

SettingDescription
Field nameName or title of the custom field as it appears on a page.
Description(Optional) A short description of the field's purpose. Can be added if the field name is not informative enough.
TypeDetermines what type of data can be stored in the field and in what format. For a detailed description of all field types, see Custom field types
Multiple values possibleEnables the field to store more than one value
Required fieldMakes input mandatory. New entities (profiles, teams, team memberships, absences) cannot be created unless a value is entered into the field.
Default valueSet a value to pre-populate the field. The value will be stored and displayed in the field until someone inputs a different value. If your field type is Checkbox, the defalt value is either checked or unchecked.

Type-specific settings. The following settings are only available for certain field types:

SettingTypeDescription
Multi-valueText, Number, List, Organization member, IssueAllow users to enter and store more than one value in the field. This option is set upon the creation of the field and cannot be changed after the field is created.
Open-endedListIn addtion to selecting predefined values, allow users to add new values (list items) to the list right on the spot.
ValuesListDefine a list of values (list items) for users to choose from. Enter a value than click Add another to enter another one. Repeat until you have defined all values.
ConstraintsText, Number, Date, Date and Time

Restrict and validate user input by setting constrains for entered values.

  • Depending on the field type, you can specify the minimum and maximum number of characters that can be entered, set a range for date selection, and so on.

  • Pattern. Use Regular Expressions to apply additional restrictions, such as predefined format and order of characters.

  • Error message. Provide a message that will be shown to the users if they enter invalid values.

Change custom fields order

If there are several custom fields on a page, by default they are displayed in the order they were created, from top to bottom.

To rearrange existing custom fields:

  1. On the navigation bar, click administration.png Administration and choose Custom Fields from the sidebar.

  2. Go to the tab that corresponds to the location of the custom fields which you want to reorder (Memberships, Member profiles, Absences, Teams)

    Existing custom fields, if any, will be listed here:

    customFieldsExisting.png
  3. Set the desired order of custom fields by dragging them up or down the list:

    customFieldsReorder.png
Last modified: 15 September 2021