{"meta":{"title":"Managing issue fields in your organization","intro":"You can create and manage custom issue fields to collect structured metadata across all issues in your organization.","product":"GitHub Issues","breadcrumbs":[{"href":"/en/issues","title":"GitHub Issues"},{"href":"/en/issues/tracking-your-work-with-issues","title":"Issues"},{"href":"/en/issues/tracking-your-work-with-issues/using-issues","title":"Using issues"},{"href":"/en/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization","title":"Managing issue fields"}],"documentType":"article"},"body":"# Managing issue fields in your organization\n\nYou can create and manage custom issue fields to collect structured metadata across all issues in your organization.\n\nIssue 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.\n\n## About issue field types\n\nYou can create up to 25 issue fields per organization. The following field types are available:\n\n* **Single-select**: choose one option from a predefined list. Options can have names, descriptions, and colors.\n* **Text**: capture free-form text. URLs are automatically detected and displayed as clickable links.\n* **Number**: accept numeric input, including decimals.\n* **Date**: provide a date picker for selecting dates.\n\n## Default fields\n\nWhen issue fields are enabled for your organization, four default fields are created automatically:\n\n* **Priority** (single-select): Urgent, High, Medium, Low\n* **Effort** (single-select): High, Medium, Low\n* **Start date** (date)\n* **Target date** (date)\n\nThese default fields are pinned to issue types as follows:\n\n| Field | No type | Bug | Task | Feature |\n| ----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| Priority | | | | |\n| Effort | | | | |\n| Start date | | | | |\n| Target date | | | | |\n\nThese default fields are fully customizable. You can edit their names, descriptions, and options, or delete them if they don't fit your workflow.\n\n> \\[!TIP]\n> 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).\n\n## Creating an issue field\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the \"Planning\" section of the sidebar, click **Issue fields**.\n5. Click **New field**.\n6. Under \"Field name\", type the name of your new field.\n7. Optionally, under \"Description\", type a description to help others understand the purpose of the field.\n8. Under \"Field type\", select the type of field you want to create.\n9. If you selected **Single-select**, add options for the field:\n * Click **Add option** and type the option name.\n * Optionally, to set a color for an option, click next to the option, click **Edit option**, choose a color, and click **Save**.\n * Repeat to add more options.\n10. Under \"Field Visibility\", choose one of the following:\n * **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.\n * **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.\n11. Click **Create**.\n\n## Editing an issue field\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the \"Planning\" section of the sidebar, click **Issue fields**.\n5. To the right of the field you want to edit, click .\n6. Click **Edit** and make your changes.\n7. Click **Save field**.\n\n## Deleting an issue field\n\nWhen you delete an issue field, all values set on issues for that field are permanently removed.\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the \"Planning\" section of the sidebar, click **Issue fields**.\n5. To the right of the field you want to delete, click .\n6. Click **Delete** and confirm the deletion.\n\n> \\[!TIP]\n> If you don't want to use issue fields, you can delete all default fields from your org settings. This removes them from all issues in your organization. You can re-create fields at any time.\n\n## Reordering issue fields\n\nThe order of pinned fields is managed per issue type. The field order determines how fields appear in the issue sidebar and the issue creation modal.\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the \"Planning\" section of the sidebar, click **Issue types**.\n5. Click the issue type you want to reorder fields for.\n6. Under \"Pinned issue fields\", drag fields to reorder them.\n7. Click **Save**.\n\n## Pinning fields to issue types\n\nYou can associate issue fields with specific issue types so that only the most relevant fields appear when creating or viewing issues of that type. For example, you can pin \"Severity\" to bugs and \"Impact\" to features.\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the \"Planning\" section of the sidebar, click **Issue fields**.\n5. Click the field you want to pin.\n6. Under \"Pin to types\", click and select the issue types this field should appear on.\n7. Click **Save field**.\n\nPinned fields automatically appear in the issue sidebar based on the selected issue type. To pin fields to issues that have no type, select the \"Issues without a type\" option.\n\n> \\[!NOTE]\n> Fields must be pinned to at least one issue type, or to \"Issues without a type\", to appear in the issue sidebar. Fields that are not pinned to any type are only accessible via the **Add field** button or in projects.\n\nIf a field is not appearing on your issues, check that it is pinned to the relevant issue type or to \"Issues without a type\". Fields that are not pinned and have no value set are hidden from the issue sidebar.\n\n## Setting field visibility\n\nFor organizations with public repositories, you can control whether each issue field is visible to everyone or only to organization members and collaborators.\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the \"Planning\" section of the sidebar, click **Issue fields**.\n5. To the right of the field, click .\n6. Click **Edit**.\n7. Under \"Field Visibility\", choose one of the following:\n * **Organization only**: the field is visible only to organization members and repository collaborators with at least read access.\n * **Public**: the field is visible to anyone viewing the issue.\n8. Click **Save**.\n\nBy default, all new and existing fields are set to \"Organization only\". Visibility settings are enforced across the web UI, API, issue timeline events, and search suggestions.\n\n## Issue fields and projects\n\nIssue fields are available in any project across your organization, including public and internal projects. For details on adding, removing, and editing issue fields in projects, see [About issue fields in projects](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields).\n\n### Visibility in public and internal projects\n\nOnly fields with **Public** visibility are available in public and internal projects. Fields set to **Organization only** are not displayed. When adding fields to a public project, only public-visibility fields appear in the add-field dialog.\n\nIf a field's visibility is changed from \"Public\" to \"Organization only\" while in use in a public project, the field is automatically removed from the project. To restore it, change the field's visibility back to \"Public.\"\n\n### Migrating from project fields to issue fields\n\nIf you already use project-level custom fields for metadata like priority or effort, you can adopt issue fields to centralize those values at the issue level.\n\n* Issue fields are the source of truth. The value lives on the issue and is consistent across all projects the issue belongs to.\n* Project fields are scoped to a single project. The same issue can have different project field values in different projects.\n* Both can coexist. You do not need to remove project fields immediately, but having both can cause confusion if they track the same concept (for example, two \"Priority\" fields).\n* To migrate, create the equivalent issue field, then remove the project-level field from your project views when your team is ready.\n\n### Field limits in projects\n\nProjects support up to 50 fields in total, and issue fields and system fields count toward this limit. If a project is already at the field limit, you need to remove existing fields before issue fields can be added.\n\n## Limits\n\n| Resource | Limit |\n| -------------------------------------------------------------------- | ----- |\n| Issue fields per organization | 25 |\n| Options per single-select field | 100 |\n| Pinned fields per issue type | 10 |\n| Total fields in a project (including issue fields and system fields) | 50 |"}