52937ae5ca
Co-authored-by: Rachael Sewell <rachmari@github.com> Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Co-authored-by: David Jarzebowski <davidjarzebowski@github.com> Co-authored-by: Anne-Marie <102995847+am-stead@users.noreply.github.com> Co-authored-by: Matt Pollard <mattpollard@users.noreply.github.com> Co-authored-by: Steve Guntrip <stevecat@github.com> Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Co-authored-by: Sam Browning <106113886+sabrowning1@users.noreply.github.com> Co-authored-by: Torsten Walter <torstenwalter@github.com> Co-authored-by: Henry Mercer <henrymercer@github.com> Co-authored-by: Sarah Edwards <skedwards88@github.com>
2.8 KiB
title, shortTitle, intro, versions, type, topics
| title | shortTitle | intro | versions | type | topics | |||
|---|---|---|---|---|---|---|---|---|
| Archiving items automatically | Archiving items automatically | You can configure your project's built-in workflows to automatically archive items that match a filter. |
|
tutorial |
|
About automatically archiving items
You can configure your project's built-in workflows to automatically archive items. Archiving items will help you stay below the limit of {% data variables.projects.item_limit %} items in each project.
The auto-archive workflow supports a subset of filters. You can use the following filters when configuring your workflow.
| Qualifier | Possible values | |
|---|---|---|
is |
open, closed, merged, draft, issue, pr |
|
reason |
completed, reopened, "not planned" |
|
updated |
<@today-14d (the last 14 days), <@today-3w (the last 3 weeks), <@today-1m (the last month) |
When you enable automatic archiving for issues or pull requests, items in your project that already meet your criteria will also be archived. There may be some delay in archiving large numbers of items that already meet the criteria.
Projects also have a limit on the number of archived items they can contain. Your project can contain up to {% data variables.projects.archived_item_limit %} archived items. For more information on permanently deleting items, see "AUTOTITLE."
Configuring automatic archiving in your project
{% data reusables.projects.access-workflows %}
-
In the "Default workflows" list, click Auto-archive items.{% ifversion projects-v2-workflows-ui-refresh %}
-
In the top right, click Edit.
{% else %} -
Next to When, check the item type(s) that you want to automatically archive.{% endif %}
-
In the "Filters" field, type the filter criteria you want to use to automatically archive items. You can only use the
is,reason, andupdatedfilters.{% ifversion projects-v2-workflows-ui-refresh %} -
To save your changes and enable the workflow, click Save and turn on workflow.{% else %}
-
If the workflow is disabled, click the toggle next to Off to enable the workflow.{% endif %}
