Skip to content

https://github.com/crdoconnor/strictyaml/issues/216#issuecomment-4793937538 #217

Description

@lalogonzaalo-rgb

Managing issue fields in your organization

You can create and manage custom issue fields to collect structured metadata across all issues in your organization.

Note

Issue fields are currently in public preview and subject to change. To share feedback, see the community discussion.

Issue fields let you add structured metadata to issues across your organization. Instead of relying on labels or free-text workarounds, you can create fields like priority, effort, impact, or any custom category your team needs. Fields are defined at the organization level and apply across all repositories in your organization.

About issue field types

You can create up to 25 issue fields per organization. The following field types are available:

  • Single-select: choose one option from a predefined list. Options can have names, descriptions, and colors.
  • Text: capture free-form text. URLs are automatically detected and displayed as clickable links.
  • Number: accept numeric input, including decimals.
  • Date: provide a date picker for selecting dates.

Default fields

When issue fields are enabled for your organization, four default fields are created automatically:

  • Priority (single-select): Urgent, High, Medium, Low
  • Effort (single-select): High, Medium, Low
  • Start date (date)
  • Target date (date)

These default fields are pinned to issue types as follows:

Field No type Bug Task Feature
Priority
Effort
Start date
Target date

These default fields are fully customizable. You can edit their names, descriptions, and options, or delete them if they don't fit your workflow.

Tip

You can rename options, change their colors, reorder them, or add new values to match your team's workflow. For example, you could change Effort options to T-shirt sizes (XS, S, M, L, XL).

Creating an issue field

  1. In the upper-right corner of GitHub, click your profile picture, then click Organizations.

  2. Select an organization by clicking on it.

  3. Under your organization name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  4. In the "Planning" section of the sidebar, click Issue fields.

  5. Click New field.

  6. Under "Field name", type the name of your new field.

  7. Optionally, under "Description", type a description to help others understand the purpose of the field.

  8. Under "Field type", select the type of field you want to create.

  9. If you selected Single-select, add options for the field:

    • Click Add option and type the option name.
    • Optionally, to set a color for an option, click next to the option, click Edit option, choose a color, and click Save.
    • Repeat to add more options.
  10. Under "Field Visibility", choose one of the following:

    • Permissions: choose who can see the field and its value. Options are Organization only (default) or Public. This setting only applies to issues in public repositories.
    • Pin to types: click to choose which issue types show this field in the issue viewer and creator. Select one or more issue types, or "Issues without a type". Fields that are not pinned and have no value will stay hidden in the issue viewer and creator.
  11. Click Create.

Editing an issue field

  1. In the upper-right corner of GitHub, click your profile picture, then click Organizations.
  2. Select an organization by clicking on it.
  3. Under your organization name, click **<path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions