github/Update project
Updates an item's fields on a GitHub Projects (beta) board based on a workflow dispatch (or other) event's input.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Mar 17, 2026
- License
- MIT
Pinned Snippet
uses: github/update-project-action@af4f6083118f5080c89828b421ef598d1906fb60 # v4tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| organization | The organization that contains the project, defaults to the current repository owner | no | ${{ github.repository_owner }} |
| project_number | The project number from the project's URL | yes | — |
| operation | Operation type (update, read, or clear) | no | update |
| content_id | The global ID of the issue or pull request within the project | yes | — |
| field | The field on the project to set the value of | yes | — |
| value | The value to set the project field to. Only required for operation type read | no | — |
| github_token | A GitHub Token with access to both the source issue and the destination project (`repo` and `write:org` scopes) | yes | — |
Outputs
| name | description |
|---|---|
| project_id | The global ID of the project |
| item_id | The global ID of the issue or pull request |
| item_title | The title of the issue or pull request |
| field_id | The global ID of the field |
| field_read_value | The value of the field before the update |
| field_updated_value | The value of the field after the update |
| field_type | The updated field's ProjectV2FieldType (text, single_select, number, date, or iteration) |
| option_id | The global ID of the selected option |