Skip to content

Commit a87148f

Browse files
moraescCopilotmchammer01
authored
Document triage access to archived pull requests (#63778)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> Copilot-Session: 13e1ed25-383c-4ea0-9c3a-0e1b5600160c
1 parent ecafe71 commit a87148f

3 files changed

Lines changed: 28 additions & 6 deletions

File tree

‎content/communities/moderating-comments-and-conversations/archive-pull-requests.md‎

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,44 @@
11
---
22
title: Archive pull requests
3-
intro: Repository administrators can archive a pull request to remove it from public view, providing a moderation option between leaving a pull request up and permanently deleting it.
3+
intro: Archiving a pull request removes it from public view without permanently deleting it.
44
versions:
55
feature: archive-pull-requests
66
category:
77
- Moderate comments and conversations
88
redirect_from:
99
- /communities/moderating-comments-and-conversations/archiving-pull-requests
1010
contentType: other
11-
permissions: Repository administrators
11+
permissions: '{% ifversion triage-archive-pull-requests %}People with triage access or higher to a repository{% else %}Repository administrators{% endif %}'
1212
---
1313

1414
## About archiving pull requests
1515

16-
Archiving a pull request removes it from public view while preserving its history for repository administrators. This provides a safer moderation path when they need to take a pull request out of public view without permanently deleting it.
16+
Archiving a pull request removes it from public view while preserving its history for {% ifversion triage-archive-pull-requests %}people with triage access or higher to the repository{% else %}repository administrators{% endif %}. This provides a safer moderation path when they need to take a pull request out of public view without permanently deleting it.
17+
18+
{% ifversion triage-archive-pull-requests %}
19+
20+
Anyone with the triage, write, maintain, or admin role in a repository can archive, unarchive, and view archived pull requests.
21+
22+
{% endif %}
1723

1824
When a pull request is archived:
1925

26+
{% ifversion triage-archive-pull-requests %}
27+
28+
* The pull request is only visible to people with triage access or higher to the repository. Visitors without this access receive a 404 error.
29+
* The pull request is automatically closed and its conversation becomes read-only. New comments, reactions, and automated comments are blocked, including comments from repository administrators.
30+
31+
When you unarchive a pull request, it becomes visible again and people can comment and react again, but it remains closed. You can reopen it separately if needed.
32+
33+
{% else %}
34+
2035
* The pull request is only visible to repository administrators. Visitors without administrator access to the repository receive a 404 error.
2136
* The pull request is automatically closed and locked.
2237

2338
When you unarchive a pull request, it becomes visible again, but it remains closed and locked. You can reopen and unlock it separately if needed.
2439

40+
{% endif %}
41+
2542
## Archiving a pull request
2643

2744
{% data reusables.repositories.navigate-to-repo %}
@@ -32,7 +49,7 @@ When you unarchive a pull request, it becomes visible again, but it remains clos
3249

3350
## Unarchiving a pull request
3451

35-
You can find the PR by using the `is:archived` qualifier. See, [AUTOTITLE](/search-github/searching-on-github/searching-issues-and-pull-requests#search-based-on-whether-a-pull-request-is-archived).
52+
You can find archived pull requests by using the `is:archived` qualifier. See [AUTOTITLE](/search-github/searching-on-github/searching-issues-and-pull-requests#search-based-on-whether-a-pull-request-is-archived).
3653

3754
1. Open the pull request you want to unarchive.
3855
1. In the right sidebar, click **{% octicon "archive" aria-hidden="true" aria-label="unarchive" %} Unarchive pull request**.

‎content/search-github/searching-on-github/searching-issues-and-pull-requests.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,11 +72,11 @@ You can filter issues and pull requests based on whether they're open or closed
7272

7373
## Search based on whether a pull request is archived
7474

75-
Repository administrators can archive a pull request to remove it from public view. You can search for archived pull requests using the `is:archived` qualifier. For more information, see [AUTOTITLE](/communities/moderating-comments-and-conversations/archive-pull-requests).
75+
{% ifversion triage-archive-pull-requests %}People with triage access or higher to a repository can archive, unarchive, and view archived pull requests. Archiving removes a pull request from public view.{% else %}Repository administrators can archive a pull request to remove it from public view.{% endif %} You can search for archived pull requests using the `is:archived` qualifier. For more information, see [AUTOTITLE](/communities/moderating-comments-and-conversations/archive-pull-requests).
7676

7777
| Qualifier | Example
7878
| ------------- | -------------
79-
| `is:archived` | [**is:archived is:pr spam**](https://github.com/search?q=is%3Aarchived+is%3Apr+spam&ref_product=github&ref_type=engagement&ref_style=text) matches archived pull requests that contain the word "spam" in repositories where you are a repository administrator.
79+
| `is:archived` | [**is:archived is:pr spam**](https://github.com/search?q=is%3Aarchived+is%3Apr+spam&ref_product=github&ref_type=engagement&ref_style=text) matches archived pull requests that contain the word "spam" in repositories where you {% ifversion triage-archive-pull-requests %}have triage access or higher{% else %}are a repository administrator{% endif %}.
8080

8181
{% endif %}
8282

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Reference: https://github.blog/changelog/2026-10-08-triage-role-users-or-higher-can-now-archive-pull-requests/
2+
# Expanded permissions and read-only conversations for archived pull requests
3+
versions:
4+
fpt: '*'
5+
ghec: '*'

0 commit comments

Comments
 (0)