{"meta":{"title":"Creating discussion category forms","intro":"You can customize the templates that are available for community members to use when they open new discussions in your repository.","product":"GitHub Discussions","breadcrumbs":[{"href":"/en/discussions","title":"GitHub Discussions"},{"href":"/en/discussions/managing-discussions-for-your-community","title":"Managing discussions"},{"href":"/en/discussions/managing-discussions-for-your-community/creating-discussion-category-forms","title":"Create discussion category forms"}],"documentType":"article"},"body":"# Creating discussion category forms\n\nYou can customize the templates that are available for community members to use when they open new discussions in your repository.\n\n## About discussion category forms\n\nYou can encourage community members to include specific, structured information in their discussions by using discussion forms in your repository. With discussion category forms, you can create discussion templates that have customizable web form fields. Discussion forms are written in YAML using the GitHub form schema. For more information, see [Syntax for GitHub's form schema](/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema).\n\nIf you're new to YAML and want to learn more, see [Learn YAML in Y minutes](https://learnxinyminutes.com/docs/yaml/).\n\nTo use a discussion category form in your repository, you must create a new file and add it to the `/.github/DISCUSSION_TEMPLATE/` folder in your repository.\n\nYou can also create discussion category forms for your organization. For more information, see [Creating a default community health file](/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file).\n\nDiscussion category forms are not supported for polls. For more information about polls, see [About discussions](/en/discussions/collaborating-with-your-community-using-discussions/about-discussions).\n\nHere is the rendered version of the issue form.\n\n![Screenshot of a rendered discussion category form.](/assets/images/help/discussions/discussion-category-form-sample.png)\n\n## Creating discussion category forms\n\nPeople with write access to a repository can create a discussion category form.\n\n1. Navigate to the repository where you want to create a discussion category form.\n2. In your repository, create a file called `/.github/DISCUSSION_TEMPLATE/FORM-NAME.yml`, replacing `FORM-NAME` with the name for your discussion category form. The name must correspond with the slug for one of your discussion categories. For example, the template for the \"Announcements\" category should be `.github/DISCUSSION_TEMPLATE/announcements.yml`. For more information about creating new files on GitHub, see [Creating new files](/en/repositories/working-with-files/managing-files/creating-new-files).\n3. In the body of the new file, type the contents of your discussion category form. For more information, see [Syntax for discussion category forms](/en/discussions/managing-discussions-for-your-community/syntax-for-discussion-category-forms).\n4. Commit your file to the default branch of your repository. For more information, see [Creating new files](/en/repositories/working-with-files/managing-files/creating-new-files)."}