Skip to main content

Adding items automatically

You can configure your project's built-in workflows to automatically add items from a repository that match a filter.

Note

Project workflow automations must be enabled by an enterprise owner in the enterprise settings page for policies for projects. For more information, see "Enforcing policies for projects in your enterprise."

About automatically adding items

You can configure your project's built-in workflows to automatically add new items as they are created or updated in a repository. You can define a filter to only add items that meet your criteria.

When you enable the auto-add workflow, existing items matching your criteria will not be added. The workflow will add items when created or updated if the item matches your filter. For more information on manually adding items, see Adding items to your project.

The auto-add workflow supports a subset of filters. You can use the following filters when configuring your workflow.

QualifierPossible values
isopen, closed, merged, draft, issue, pr
label"label name"
reasoncompleted, reopened, "not planned"
assigneeGitHub Enterprise Server username
nolabel, assignee, reason

All filters, other than no, support negation. For example, you could use -label:bug to add issues that do not have the "bug" label.

Configuring the auto-add workflow in your project

  1. Navigate to your project.

  2. In the top-right, click to open the menu.

    Screenshot showing a project's menu bar. The menu icon is highlighted with an orange outline.

  3. In the menu, click Workflows.

  4. In the "Default workflows" list, click Auto-add to project.

  5. To start editing the workflow, in the top right, click Edit.

    Screenshot showing the workflow menu bar. The "Edit" button is highlighted with an orange rectangle.

  6. Under "Filters", select the repository you want to add items from.

  7. Next to the repository selection, type the filter criteria you want items to match before they are automatically added to your project.

  8. To enable the new workflow, click Save and turn on workflow.

Further reading