https://github.com/peter-evans/create-issue-from-file

A GitHub action to create an issue using content from a file
https://github.com/peter-evans/create-issue-from-file

github-action github-issues

Last synced: about 18 hours ago
JSON representation

A GitHub action to create an issue using content from a file

• Host: GitHub
• URL: https://github.com/peter-evans/create-issue-from-file
• Owner: peter-evans
• License: mit
• Created: 2019-07-06T06:27:36.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2025-04-04T09:06:11.000Z (10 days ago)
• Last Synced: 2025-04-06T21:10:02.829Z (8 days ago)
• Topics: github-action, github-issues
• Language: TypeScript
• Homepage:
• Size: 30.1 MB
• Stars: 151
• Watchers: 5
• Forks: 33
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-actions - this Action
• awesome-actions - Create an issue using content from a file
• fucking-awesome-actions - Create an issue using content from a file
• awesome-workflows - Create an issue using content from a file
• jimsghstars - peter-evans/create-issue-from-file - A GitHub action to create an issue using content from a file (TypeScript)

README

        
# Create Issue From File

[![CI](https://github.com/peter-evans/create-issue-from-file/workflows/CI/badge.svg)](https://github.com/peter-evans/create-issue-from-file/actions?query=workflow%3ACI)

[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-Create%20Issue%20From%20File-blue.svg?colorA=24292e&colorB=0366d6&style=flat&longCache=true&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAM6wAADOsB5dZE0gAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAERSURBVCiRhZG/SsMxFEZPfsVJ61jbxaF0cRQRcRJ9hlYn30IHN/+9iquDCOIsblIrOjqKgy5aKoJQj4O3EEtbPwhJbr6Te28CmdSKeqzeqr0YbfVIrTBKakvtOl5dtTkK+v4HfA9PEyBFCY9AGVgCBLaBp1jPAyfAJ/AAdIEG0dNAiyP7+K1qIfMdonZic6+WJoBJvQlvuwDqcXadUuqPA1NKAlexbRTAIMvMOCjTbMwl1LtI/6KWJ5Q6rT6Ht1MA58AX8Apcqqt5r2qhrgAXQC3CZ6i1+KMd9TRu3MvA3aH/fFPnBodb6oe6HM8+lYHrGdRXW8M9bMZtPXUji69lmf5Cmamq7quNLFZXD9Rq7v0Bpc1o/tp0fisAAAAASUVORK5CYII=)](https://github.com/marketplace/actions/create-issue-from-file)

A GitHub action to create an issue using content from a file.

This is designed to be used in conjunction with other actions that output to a file.

Especially if that output can be formatted as [GitHub flavoured Markdown](https://docs.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax).

This action will create an issue if a file exists at a specified path.

The content of the issue will be taken from the file as-is.

If the file does not exist the action exits silently.

## Usage

```yml

      - name: Create Issue From File

        uses: peter-evans/create-issue-from-file@v5

        with:

          title: An example issue

          content-filepath: ./example-content/output.md

          labels: |

            report

            automated issue

```

### Action inputs

| Name | Description | Default |

| --- | --- | --- |

| `token` | `GITHUB_TOKEN` or a `repo` scoped [PAT](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) | `GITHUB_TOKEN` |

| `repository` | The target GitHub repository | Current repository |

| `issue-number` | The issue number of an existing issue to update | |

| `title` | (**required**) The title of the issue | |

| `content-filepath` | The file path to the issue content | |

| `labels` | A comma or newline-separated list of labels | |

| `assignees` | A comma or newline-separated list of assignees (GitHub usernames) | |

### Outputs

- `issue-number` - The number of the created issue

## License

MIT License - see the [LICENSE](LICENSE) file for details