{"meta":{"title":"Using GitHub Copilot to create or update issues","intro":"Use Copilot to quickly generate structured, high-quality issues from natural language or images, without filling out every field manually.","product":"GitHub Copilot","breadcrumbs":[{"href":"/en/copilot","title":"GitHub Copilot"},{"href":"/en/copilot/how-tos","title":"How-tos"},{"href":"/en/copilot/how-tos/copilot-on-github","title":"Copilot on GitHub"},{"href":"/en/copilot/how-tos/copilot-on-github/copilot-for-github-tasks","title":"Copilot for GitHub tasks"},{"href":"/en/copilot/how-tos/copilot-on-github/copilot-for-github-tasks/use-copilot-to-create-or-update-issues","title":"Use Copilot to create or update issues"}],"documentType":"article"},"body":"# Using GitHub Copilot to create or update issues\n\nUse Copilot to quickly generate structured, high-quality issues from natural language or images, without filling out every field manually.\n\n> \\[!NOTE]\n> This feature is in public preview and subject to change.\n\nCopilot can create or update issues from a natural-language prompt or a screenshot. It fills in the title, body, labels, assignees, and more—using your repository's issue forms or templates when available. Review and refine every draft before you submit.\n\n## Create an issue\n\n1. Navigate to [https://github.com/copilot](https://github.com/copilot?ref_product=copilot\\&ref_type=engagement\\&ref_style=text).\n\n2. In the prompt box, describe the issue you want to create. Use `repo-owner/repo-name` to target a specific repository.\n\n For example:\n\n * In OWNER/REPOSITORY, create a feature request to add fuzzy matching to search.\n\n * Log a bug for a 500 error. This happens consistently when I try to log into the site.\n\n * Create a task to change the application logo background to red and add the label \"needs design review\".\n\n > \\[!NOTE] You can only create issues in repositories where you already have permission to do so.\n\n3. Optionally, paste, drag, or attach an image to your prompt. Add text to describe the issue, for example: `Create an issue because this error appears when trying to reset a password.`\n\n4. Copilot drafts an issue with a suggested title, body, and metadata (labels, assignees, issue type). If your repository has issue forms or templates, Copilot maps your prompt to the relevant fields.\n\n5. Review the draft. Edit any field, choose a different template, or ask Copilot to make changes with a follow-up prompt.\n\n6. Click **Create**.\n\n## Create multiple issues\n\nIf your prompt includes multiple tasks or bugs, Copilot drafts each one separately.\n\nFor example: In OWNER/REPOSITORY, create 3 issues: 1) DETAILS OF ONE TASK, 2) DETAILS OF ANOTHER TASK, 3) DETAILS OF A THIRD TASK\n\nReview and edit each draft individually, then click **Create** to publish.\n\n## Create sub-issues\n\nCopilot can break a task into a parent issue with sub-issues.\n\nFor example:\n\n`In octo-org/octo-repo, plan a new user dashboard. Break it down into an epic, and create sub-issues for each main feature and task.`\n\nCopilot generates a draft issue tree with a parent issue and sub-issues beneath it. Expand or collapse sub-issues, edit details, and use follow-up prompts to add or remove sub-issues.\n\nWhen you're ready, click **Review and create**, then click **Create issues**.\n\n## Update an existing issue\n\nPrompt Copilot to modify an issue that already exists. For example:\n\n`In octo-org/octo-repo, update issue #123 to add more details about the bug and steps to reproduce it. Also, change the label to \"bug\" and assign it to @username.`\n\nReview the draft in the workbench, then click **Update**.\n\n## Link to existing parent or sub-issues\n\nCopilot can connect new issues to ones that already exist. For example:\n\n* `Create a sub-issue for octo-org/octo-repo issue #456.`\n* `Create a parent issue for octo-org/octo-repo issue #456.`\n* `Create a parent issue for octo-org/octo-repo issues #456, #457, and #458.`\n\nReview the draft in the workbench, then click **Review and create** > **Create issues**.\n\n## Assign an issue to Copilot\n\nWith Copilot cloud agent enabled, you can assign an issue to Copilot during creation. See [Managing access to GitHub Copilot cloud agent](/en/copilot/concepts/agents/cloud-agent/access-management).\n\n* **Natural language:** Include `Assign this issue to Copilot.` in your prompt.\n* **Manually:** Select \"Copilot\" from the assignee list.\n\nCopilot starts working on the issue automatically after creation.\n\n## Further reading\n\n* [Configuring issue templates for your repository](/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository)\n* [Planning a project with GitHub Copilot](/en/copilot/tutorials/plan-a-project)"}