[2026-03-05] File upload field in issue forms and move items to iteration in Projects (#60048)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: sunbrye <56200261+sunbrye@users.noreply.github.com>
Co-authored-by: sunbrye <sunbrye@github.com>

Author: Copilot

content/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository.md

@@ -38,7 +38,9 @@ shortTitle: Configure
 
 {% data reusables.community.issue-forms-beta %}
 
-With issue forms, you can create issue templates that have customizable web form fields. You can encourage contributors to include specific, structured information by using issue forms in your repository. Issue forms are written in YAML using the {% data variables.product.prodname_dotcom %} form schema. For more information, see [AUTOTITLE](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema). {% data reusables.actions.learn-more-about-yaml %}
+With issue forms, you can create issue templates that have customizable web form fields. You can encourage contributors to include specific, structured information by using issue forms in your repository. 
+
+{% ifversion issue-form-upload %}Issue forms support several field types, including text inputs, dropdowns, checkboxes, and file uploads.{% endif %} Issue forms are written in YAML using the {% data variables.product.prodname_dotcom %} form schema. For more information, see [AUTOTITLE](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema). {% data reusables.actions.learn-more-about-yaml %}
 
 To use an issue form in your repository, you must create a new file and add it to the `.github/ISSUE_TEMPLATE` folder in your repository.
 

content/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema.md

@@ -59,7 +59,7 @@ For each form element, you can set the following keys.
 
 | Key | Description | Required | Type | Default | Valid values |
 | --- | ----------- | -------- | ---- | ------- | ------- |
-| `type` | The type of element that you want to define. | {% octicon "check" aria-label="Required" %} | String | {% octicon "dash" aria-label="Not applicable" %} | <ul><li>`checkboxes`</li><li>`dropdown`</li><li>`input`</li><li>`markdown`</li><li>`textarea`</li></ul> |
+| `type` | The type of element that you want to define. | {% octicon "check" aria-label="Required" %} | String | {% octicon "dash" aria-label="Not applicable" %} | <ul><li>`checkboxes`</li><li>`dropdown`</li><li>`input`</li><li>`markdown`</li><li>`textarea`</li>{% ifversion issue-form-upload %}<li>`upload`</li>{% endif %}</ul> |
 | `id` | The identifier for the element, except when `type` is set to `markdown`. {% data reusables.form-schema.id-must-be-unique %} If provided, the `id` is the canonical identifier for the field in URL query parameter prefills. | {% octicon "x" aria-label="Optional" %}  | String | {% octicon "dash" aria-label="Not applicable" %} | {% octicon "dash" aria-label="Not applicable" %} |
 | `attributes` | A set of key-value pairs that define the properties of the element.  | {% octicon "check" aria-label="Required" %} | Map | {% octicon "dash" aria-label="Not applicable" %} | {% octicon "dash" aria-label="Not applicable" %} |
 | `validations` | A set of key-value pairs that set constraints on the element. | {% octicon "x" aria-label="Optional" %}  | Map | {% octicon "dash" aria-label="Not applicable" %} | {% octicon "dash" aria-label="Not applicable" %} |
@@ -73,6 +73,9 @@ You can choose from the following types of form elements. Each type has unique a
 | [`input`](#input) | A single-line text field. |
 | [`dropdown`](#dropdown) | A dropdown menu. |
 | [`checkboxes`](#checkboxes) | A set of checkboxes. |
+| {% ifversion issue-form-upload %} |
+| [`upload`](#upload) | A file upload field. |
+| {% endif %} |
 
 ### `markdown`
 
@@ -266,6 +269,58 @@ body:
       - label: Linux
 ```
 
+{% ifversion issue-form-upload %}
+
+### `upload`
+
+You can use an `upload` element to add a file upload field to your form. Contributors can drag and drop files or click to browse and select files directly within the form.
+
+#### Supported file types and size limits
+
+The following file types are accepted, subject to the size limits below:
+
+| Category  | Extensions | Size limit |
+|-----------| ---------- | -------- |
+| Archives  | `.zip`, `.gz`, `.tar.gz` | 25 MB |
+| Documents | `.pdf`, `.docx`, `.xlsx`, `.pptx` | 25 MB |
+| Images    | `.png`, `.jpg`, `.jpeg`, `.gif`, `.svg`, `.webp` | 10 MB |
+| Videos    | `.mp4`, `.mov`, `.webm` | 100 MB |
+| Text      | `.json`, `.py`, `.js`, `.ts`, `.log`, `.txt`, `.csv` | 25 MB |
+
+#### Attributes for `upload`
+
+{% data reusables.form-schema.attributes-intro %}
+
+| Key | Description | Required | Type | Default | Valid values |
+| --- | ----------- | -------- | ---- | ------- | ------- |
+| `label` | A brief description of the expected file upload, which is displayed in the form. | {% octicon "check" aria-label="Required" %} | String | {% octicon "dash" aria-label="Not applicable" %} | {% octicon "dash" aria-label="Not applicable" %} |
+| `description` | A description of the file upload field to provide context or guidance, which is displayed in the form. | {% octicon "x" aria-label="Optional" %}  | String | Empty String | {% octicon "dash" aria-label="Not applicable" %} |
+
+#### Validations for `upload`
+
+{% data reusables.form-schema.validations-intro %}
+
+| Key | Description | Required | Type | Default | Valid values |
+| --- | ----------- | -------- | ---- | ------- | ------- |
+{% data reusables.form-schema.required-key %}
+| `accept` | A comma-separated list of file extensions that are accepted. If omitted, all supported file types are accepted. | {% octicon "x" aria-label="Optional" %} | String | {% octicon "dash" aria-label="Not applicable" %} | {% octicon "dash" aria-label="Not applicable" %} |
+
+#### Example of `upload`
+
+```yaml copy
+body:
+- type: upload
+  id: screenshots
+  attributes:
+    label: Upload relevant files
+    description: "Drag and drop any relevant screenshots or log files."
+  validations:
+    required: false
+    accept: ".png,.jpg,.gif,.log,.txt,.zip"
+```
+
+{% endif %}
+
 ## Further reading
 
 * [YAML](https://yaml.org)

content/issues/planning-and-tracking-with-projects/understanding-fields/about-iteration-fields.md

@@ -62,3 +62,14 @@ You can insert breaks into your iterations to communicate when you are taking ti
    ![Screenshot of the list of iterations for a project. On the line dividing two iterations, a button, labeled "Insert break," is outlined in orange.](/assets/images/help/issues/iteration-insert-break.png)
 1. Optionally, to change the duration of the break, click on the date to open the calendar. Click on the start day, then click the end day, and then click **Apply**.
 1. Click **Save changes**.
+
+## Moving items between iterations
+
+When a project view is grouped by an iteration field, you can bulk-move all items from one iteration to another. This is useful for rolling over unfinished work to the next sprint, rescheduling items during reprioritization, or clearing a backlog iteration.
+
+1. Navigate to your project.
+1. In your project, group a view by an iteration field. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout#grouping-by-field-values).
+1. Click {% octicon "kebab-horizontal" aria-label="iteration options" %} in the group header for the iteration you want to move items from.
+1. Click **Move items to...**.
+1. Select the target iteration you want to move the items to.
+1. Confirm the move. All items in the group are updated to the target iteration.

data/features/issue-form-upload.yml

@@ -0,0 +1,6 @@
+# Reference: https://github.com/github/releases/issues/7534
+# File upload field in issue forms
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '>= 3.21'

data/reusables/community/issue-forms-sample.md

@@ -63,5 +63,12 @@ body:
       description: By submitting this issue, you agree to follow our [Code of Conduct](https://example.com).
       options:
         - label: I agree to follow this project's Code of Conduct
-          required: true
+          required: true{% ifversion issue-form-upload %}
+  - type: upload
+    id: screenshots
+    attributes:
+      label: Upload screenshots
+      description: If applicable, add screenshots to help explain your problem.
+    validations:
+      required: false{% endif %}
 ```

data/reusables/projects/open-view-menu.md

@@ -1,3 +1,2 @@
-1. Click {% octicon "triangle-down" aria-label="View options" %} next to the name of the currently open view.
+1. Click **{% octicon "gear" aria-label="View options" %} View** next to the search bar of the currently open view.
 
-   ![Screenshot showing the tabs at the top of a project. The view menu icon is highlighted with an orange outline.](/assets/images/help/projects-v2/view-menu-icon.png)