upload-artifact

Use actions/upload-artifact@v7 to upload individual files, entire directories, or files matching wildcard patterns.

• Individual Files: Provide the specific file path. Use archive: false to upload the file unzipped.
• Directories: Provide the directory path. The hierarchy within the directory is preserved.
• Wildcards: Supports glob patterns (e.g., path/**/[abc]rtifac?/*). Note that the path hierarchy is preserved after the first wildcard pattern, which may result in a flattened structure.
• Multiple Paths: You can provide multiple paths using YAML multiline syntax. If multiple paths are provided, the least common ancestor of all search paths is used as the root directory. You can use ! to exclude specific patterns.
• Relative vs Absolute: Relative paths are rooted against the current working directory. Absolute paths are also supported.

### Upload an Individual File (Zipped)
```yaml
steps:
- run: mkdir -p path/to/artifact
- run: echo hello > path/to/artifact/world.txt
- uses: actions/upload-artifact@v7
  with:
    name: my-artifact
    path: path/to/artifact/world.txt

Upload an Individual File (Unzipped)

steps:
- run: mkdir -p path/to/artifact
- run: echo hello > path/to/artifact/world.txt
- uses: actions/upload-artifact@v7
  with:
    path: path/to/artifact/world.txt
    archive: false

Upload an Entire Directory

- uses: actions/upload-artifact@v7
  with:
    name: my-artifact
    path: path/to/artifact/ # or path/to/artifact

Upload using a Wildcard Pattern

- uses: actions/upload-artifact@v7
  with:
    name: my-artifact
    path: path/**/[abc]rtifac?/*

Upload using Multiple Paths and Exclusions

- uses: actions/upload-artifact@v7
  with:
    name: my-artifact
    path: |
      path/output/bin/
      path/output/test-results
      !path/**/*.tmp

In v4, Artifacts are immutable. Unlike v3, you cannot upload multiple files to the same artifact name across different jobs. To achieve the same result (collecting files from a matrix into one directory), you must:

1. Give each upload a unique name using a suffix (e.g., name: my-artifact-${{ matrix.runs-on }}).
2. Use actions/download-artifact@v4 with the pattern input to match the names and the merge-multiple: true input to download them into a single directory.

jobs:
  upload:
    strategy:
      matrix:
        runs-on: [ubuntu-latest, macos-latest, windows-latest]
    runs-on: ${{ matrix.runs-on }}
    steps:
    - name: Create a File
      run: echo "hello from ${{ matrix.runs-on }}" > file-${{ matrix.runs-on }}.txt
    - name: Upload Artifact
      uses: actions/upload-artifact@v4
      with:
        name: my-artifact-${{ matrix.runs-on }}
        path: file-${{ matrix.runs-on }}.txt
  download:
    needs: upload
    runs-on: ubuntu-latest
    steps:
    - name: Download All Artifacts
      uses: actions/download-artifact@v4
      with:
        pattern: my-artifact-*
        merge-multiple: true
        path: my-artifact

To combine multiple artifacts (e.g., from a matrix) into a single archive for external use, use the actions/upload-artifact/merge@v4 action. This action downloads all artifacts matching a pattern to a temporary directory and re-uploads them as a single new artifact.

jobs:
  upload:
    strategy:
      matrix:
        runs-on: [ubuntu-latest, macos-latest, windows-latest]
    runs-on: ${{ matrix.runs-on }}
    steps:
      - name: Create a File
        run: echo "hello from ${{ matrix.runs-on }}" > file-${{ matrix.runs-on }}.txt
      - name: Upload Artifact
        uses: actions/upload-artifact@v4
        with:
          name: my-artifact-${{ matrix.runs-on }}
          path: file-${{ matrix.runs-on }}.txt
  merge:
    runs-on: ubuntu-latest
    needs: upload
    steps:
      - name: Merge Artifacts
        uses: actions/upload-artifact/merge@v4
        with:
          name: all-my-files
          pattern: my-artifact-*