# GitHub Issues documentation Learn how you can use GitHub Issues to plan and track your work. ## Recommended * [Quickstart for GitHub Issues](/en/issues/tracking-your-work-with-issues/learning-about-issues/quickstart) Follow this brief interactive guide to learn about GitHub Issues. * [About issues](/en/issues/tracking-your-work-with-issues/learning-about-issues/about-issues) Learn how you can use GitHub Issues to track ideas, feedback, tasks, or bugs. * [Planning and tracking work for your team or project](/en/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project) The essentials for using GitHub's planning and tracking tools to manage work on a team or project. * [Quickstart for Projects](/en/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects) Experience the speed, flexibility, and customization of Projects by creating a project in this interactive guide. * [Best practices for Projects](/en/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects) Learn tips for managing your projects. * [Creating an issue](/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue) Issues can be created in a variety of ways, so you can choose the most convenient method for your workflow. * [Changing the layout of a view](/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view) You can view your project as a high-density table, as a kanban board, or as a timeline-style roadmap. * [Using the built-in automations](/en/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations) You can use built-in workflows to automate your projects. * [Triaging an issue with AI](/en/issues/tracking-your-work-with-issues/administering-issues/triaging-an-issue-with-ai) Use AI to triage new issues and determine whether the issue is actionable or needs more information. ## Links ### Getting started * [About issues](/en/issues/tracking-your-work-with-issues/learning-about-issues/about-issues) Learn how you can use GitHub Issues to track ideas, feedback, tasks, or bugs. * [Quickstart for GitHub Issues](/en/issues/tracking-your-work-with-issues/learning-about-issues/quickstart) Follow this brief interactive guide to learn about GitHub Issues. ## Articles * [About issues](/en/issues/tracking-your-work-with-issues/learning-about-issues/about-issues) Learn how you can use GitHub Issues to track ideas, feedback, tasks, or bugs. * [Quickstart for GitHub Issues](/en/issues/tracking-your-work-with-issues/learning-about-issues/quickstart) Follow this brief interactive guide to learn about GitHub Issues. * [Planning and tracking work for your team or project](/en/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project) The essentials for using GitHub's planning and tracking tools to manage work on a team or project. * [Creating an issue](/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue) Issues can be created in a variety of ways, so you can choose the most convenient method for your workflow. * [Adding sub-issues](/en/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues) Learn about using sub-issues to break down your work into tasks. * [Creating issue dependencies](/en/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies) Learn how to create issue dependencies so that you can see which issues are blocked by, or blocking, other work. * [Assigning issues and pull requests to other GitHub users](/en/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users) Assignees clarify who is working on specific issues and pull requests. * [Editing an issue](/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) Learn how to make changes to an existing issue. * [Viewing all issues and pull requests](/en/issues/tracking-your-work-with-issues/using-issues/viewing-all-of-your-issues-and-pull-requests) The Issues and Pull Request dashboards list the open issues and pull requests you've created, as well as your saved views. You can use them to update items that have gone stale, close them, or keep track of where you've been mentioned across all repositories—including those you're not subscribed to. * [Browsing sub-issues](/en/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues) Learn how to navigate issue hierarchy in your repositories. * [Filtering and searching issues and pull requests](/en/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests) To find detailed information about a repository on GitHub, you can filter, sort, and search issues and pull requests that are relevant to the repository. * [Creating a branch to work on an issue](/en/issues/tracking-your-work-with-issues/using-issues/creating-a-branch-for-an-issue) You can create a branch to work on an issue directly from the issue page and get started right away. * [Linking a pull request to an issue](/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue) You can link a pull request or branch to an issue to show that a fix is in progress and to automatically close the issue when the pull request or branch is merged. * [About slash commands](/en/issues/tracking-your-work-with-issues/using-issues/about-slash-commands) Slash commands can save you time by reducing the typing required to create complex Markdown. * [Managing issue types in an organization](/en/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization) Learn about issue types and how to manage them in your organization. * [Managing issue fields in your organization](/en/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization) You can create and manage custom issue fields to collect structured metadata across all issues in your organization. * [Adding and managing issue fields](/en/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields) You can set, edit, and clear issue field values on individual issues to capture structured metadata for your team. * [Triaging an issue with AI](/en/issues/tracking-your-work-with-issues/administering-issues/triaging-an-issue-with-ai) Use AI to triage new issues and determine whether the issue is actionable or needs more information. * [Pinning an issue to your repository](/en/issues/tracking-your-work-with-issues/administering-issues/pinning-an-issue-to-your-repository) You can pin up to three important issues above the issues list in your repository. * [Marking issues or pull requests as a duplicate](/en/issues/tracking-your-work-with-issues/administering-issues/marking-issues-or-pull-requests-as-a-duplicate) Mark an issue or pull request as a duplicate to track similar issues or pull requests together and remove unnecessary burden for both maintainers and collaborators. * [Transferring an issue to another repository](/en/issues/tracking-your-work-with-issues/administering-issues/transferring-an-issue-to-another-repository) To move an issue to a better fitting repository, you can transfer open issues to other repositories. * [Closing an issue](/en/issues/tracking-your-work-with-issues/administering-issues/closing-an-issue) You can close an issue when bugs are fixed, feedback is acted on, or to show that work is not planned. * [Deleting an issue](/en/issues/tracking-your-work-with-issues/administering-issues/deleting-an-issue) People with admin permissions in a repository can permanently delete an issue from a repository. * [Cloning an issue](/en/issues/tracking-your-work-with-issues/administering-issues/cloning-an-issue) To quickly create a similar issue, you can clone an existing open issue into the same repository or a different one. * [About Projects](/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects) Projects is an adaptable, flexible tool for planning and tracking work on GitHub. * [Quickstart for Projects](/en/issues/planning-and-tracking-with-projects/learning-about-projects/quickstart-for-projects) Experience the speed, flexibility, and customization of Projects by creating a project in this interactive guide. * [Best practices for Projects](/en/issues/planning-and-tracking-with-projects/learning-about-projects/best-practices-for-projects) Learn tips for managing your projects. * [Creating a project](/en/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project) Learn how to create an organization or user project. * [Copying an existing project](/en/issues/planning-and-tracking-with-projects/creating-projects/copying-an-existing-project) You can use an existing project as a template by copying it. * [Adding items to your project](/en/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project) Learn how to add pull requests, issues, and draft issues to your projects individually or in bulk. * [Converting draft issues to issues](/en/issues/planning-and-tracking-with-projects/managing-items-in-your-project/converting-draft-issues-to-issues) Learn how to convert draft issues into issues. * [Editing items in your project](/en/issues/planning-and-tracking-with-projects/managing-items-in-your-project/editing-items-in-your-project) There are several methods you can use within your project to quickly make changes to multiple items. * [Archiving items from your project](/en/issues/planning-and-tracking-with-projects/managing-items-in-your-project/archiving-items-from-your-project) You can archive items, keeping them available to restore, or permanently delete them. * [About text and number fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-text-and-number-fields) You can add custom text and number fields to your project. * [About date fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-date-fields) You can create custom date fields that can be set by typing a date or using a calendar. * [About single select fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-single-select-fields) You can create single select fields with multiple options, each with a description and a color, that can be selected from a dropdown menu. * [About iteration fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-iteration-fields) You can create iterations to plan upcoming work and group items. * [About issue fields in projects](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields) Learn how to use organization-level issue fields in your projects to track structured metadata like priority, effort, and dates. * [About parent issue and sub-issue progress fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-parent-issue-and-sub-issue-progress-fields) You can show an issue's parent issue and view sub-issue progress in your projects. * [About pull request fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-pull-request-fields) You can show a linked pull request and the pull request reviewers in your projects. * [About the issue type field](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-the-issue-type-field) You can show the type of the issue in your projects. * [Renaming custom fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/renaming-custom-fields) Learn about renaming existing custom fields in your project. * [Deleting custom fields](/en/issues/planning-and-tracking-with-projects/understanding-fields/deleting-custom-fields) Learn how to delete a custom field from your project. * [Changing the layout of a view](/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view) You can view your project as a high-density table, as a kanban board, or as a timeline-style roadmap. * [Customizing the table layout](/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout) You can use the table layout to build a spreadsheet using your project's items, GitHub metadata, and your custom fields. * [Customizing the board layout](/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout) You can use the board layout to arrange your project's items over customizable columns. * [Customizing the roadmap layout](/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-roadmap-layout) You can use the roadmap layout to view your project's items on a timeline. * [Filtering projects](/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects) Use filters to choose which items appear in your project's views. * [Managing your views](/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/managing-your-views) Learn how to create, save, and manage your project views. * [Using the built-in automations](/en/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations) You can use built-in workflows to automate your projects. * [Using the API to manage Projects](/en/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects) You can use the GraphQL API to automate your projects. * [Automating Projects using Actions](/en/issues/planning-and-tracking-with-projects/automating-your-project/automating-projects-using-actions) You can use GitHub Actions to automate your projects. * [Adding items automatically](/en/issues/planning-and-tracking-with-projects/automating-your-project/adding-items-automatically) You can configure your project's built-in workflows to automatically add items from repositories that match a filter. * [Archiving items automatically](/en/issues/planning-and-tracking-with-projects/automating-your-project/archiving-items-automatically) You can configure your project's built-in workflows to automatically archive items that match a filter. * [About insights for Projects](/en/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/about-insights-for-projects) You can view and customize charts that are built from your project's data. * [Creating charts](/en/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/creating-charts) Learn how to create new charts to save your configurations. * [Configuring charts](/en/issues/planning-and-tracking-with-projects/viewing-insights-from-your-project/configuring-charts) Learn how to configure your charts and filter data from your project. * [Managing visibility of your projects](/en/issues/planning-and-tracking-with-projects/managing-your-project/managing-visibility-of-your-projects) Learn about setting your project to private or public visibility. * [Managing access to your projects](/en/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects) Learn how to manage team and individual access to your project. * [Managing project templates in your organization](/en/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization) You can create templates or set projects as templates in your organization, allowing other people to select your template as the base for projects they create. * [Closing and deleting your projects](/en/issues/planning-and-tracking-with-projects/managing-your-project/closing-and-deleting-your-projects) Learn about closing, re-opening, and permanently deleting a project. * [Adding your project to a repository](/en/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-repository) You can add your project to a repository to make it accessible from that repository. * [Adding your project to a team](/en/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team) You can add projects to teams to manage permissions and improve project discoverability. * [Exporting your project data](/en/issues/planning-and-tracking-with-projects/managing-your-project/exporting-your-projects-data) Learn about exporting your project data. * [Finding your projects](/en/issues/planning-and-tracking-with-projects/finding-your-projects) Learn how to locate projects in your account, organizations, repositories, and teams. * [Sharing project updates](/en/issues/planning-and-tracking-with-projects/sharing-project-updates) You can post updates to your projects that share the current status, start date, and target date of the project itself. * [Managing labels](/en/issues/using-labels-and-milestones-to-track-work/managing-labels) You can classify issues and pull requests by creating, editing, applying, and deleting labels. * [About milestones](/en/issues/using-labels-and-milestones-to-track-work/about-milestones) You can use milestones to track progress on groups of issues or pull requests in a repository. * [Creating and editing milestones for issues and pull requests](/en/issues/using-labels-and-milestones-to-track-work/creating-and-editing-milestones-for-issues-and-pull-requests) You can create a milestone to track progress on groups of issues or pull requests in a repository. * [Associating milestones with issues and pull requests](/en/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests) You can associate similar issues and pull requests with a milestone to better track their progress. * [Filtering issues and pull requests by milestone](/en/issues/using-labels-and-milestones-to-track-work/filtering-issues-and-pull-requests-by-milestone) Issues and pull requests can be filtered based on the milestone they're associated with. Once you've associated an issue or pull request with a milestone, you can find items based on their milestones. Within a milestone, you can prioritize issues and pull requests. * [Viewing your milestone's progress](/en/issues/using-labels-and-milestones-to-track-work/viewing-your-milestones-progress) In order to track your milestones, you'll want to get a better understanding of how many open issues and pull requests are remaining.