Skip to content
GitHub Action that uploads coverage to Codecov ☂️
Shell Dockerfile
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information. rem header comments Aug 8, 2019
Dockerfile clean up comments Aug 8, 2019
LICENSE Create LICENSE Aug 7, 2019 correct installation line org to `codecov` Aug 16, 2019
action.yml rem header comments Aug 8, 2019 delete debug output Aug 8, 2019

Codecov GitHub Action

GitHub Marketplace

Easily upload coverage reports to Codecov from GitHub Actions


To integrate Codecov with your Actions pipeline, specify the name of this repository with a tag number as a step within your workflow.yml file. This Action also requires you to provide an upload token from (tip: in order to avoid exposing your token, store it as a secret). Optionally, you can choose to include three additional inputs to customize the upload context.

Inside your .github/workflows/workflow.yml file:

- uses: actions/checkout@master
- uses: codecov/codecov-action@v1.0.0
    token: ${{secrets.CODECOV_TOKEN}} #required
    file: ./coverage.xml #optional
    flags: unittests #optional
    name: codecov-umbrella #optional

Note: This assumes that you've set your Codecov token inside Settings > Secrets as CODECOV_TOKEN. If not, you can get an upload token for your specific repo on


Codecov's Action currently supports four inputs from the user: token, file, flags, and name. These inputs, along with their descriptions and usage contexts, are listed in the table below:

Input Description Usage
token Used to authorize coverage report uploads Required
file Location of the coverage report Optional
flags Flag upload under a certain group Optional
name Custom defined name for the upload Optional

Example workflow.yml with Codecov Action

name: Example workflow for Codecov
on: [push]
    runs-on: ubuntu-latest
    - uses: actions/checkout@master
    - name: Setup Python  
      uses: actions/setup-python@master
        version: 3.7
    - name: Generate coverage report
      run: |
        pip install pytest
        pip install pytest-cov
        pytest --cov=./ --cov-report=xml
    - name: Upload coverage to Codecov  
      uses: codecov/codecov-action@v1.0.0
        token: ${{secrets.CODECOV_TOKEN}}
        file: ./coverage.xml
        flags: unittests
        name: codecov-umbrella 


Contributions are welcome! Check out the Contribution Guide.


The code in this project is released under the MIT License.

You can’t perform that action at this time.