mirror of
				https://github.com/actions/upload-artifact.git
				synced 2025-10-31 15:13:44 +00:00 
			
		
		
		
	upload-artifact
This uploads artifacts from your workflow.
See also download-artifact.
Usage
See action.yml
Basic:
steps:
- uses: actions/checkout@v1
- run: mkdir -p path/to/artifact
- run: echo hello > path/to/artifact/world.txt
- uses: actions/upload-artifact@v1
  with:
    name: my-artifact
    path: path/to/artifact
To upload artifacts only when the previous step of a job failed, use if: failure():
- uses: actions/upload-artifact@v1
  if: failure()
  with:
    name: my-artifact
    path: path/to/artifact
Where does the upload go?
In the top right corner of a workflow run, once the run is over, if you used this action, there will be a Artifacts dropdown which you can download items from. Here's a screenshot of what it looks like

There is a trashcan icon that can be used to delete the artifact. This icon will only appear for users who have write permissions to the repository.
License
The scripts and documentation in this project are released under the MIT License
					Languages
				
				
								
								
									TypeScript
								
								99.3%
							
						
							
								
								
									JavaScript
								
								0.7%