Code coverage done right.®

Welcome to Codecov Documentation. You'll find comprehensive guides and documentation to help you start working with Codecov as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Error Reference

Missing base commit

Improving this feature. Please share feeback on our community forums.

In order to produce an accurate coverage comparison, Codecov must have the coverage report for the pull request base.

Best Practice: Always fork a branch from a successful CI commit that has coverage uploaded, as illustrated below.

This issue occurs when the base commit (the parent commit of the first commit on the pull request) did not upload coverage and/or failed CI tests.

# [legend] P=CI-Passed, F=CI-Failed, .=No-CI-Ran

# Illustration A
master . F . .
pull      \ . . P
# Base commit's CI failed therefore base report is invalid.
# Resulting in "missing base report"


# Illustration B
master . . . .
pull        \ . . P
# Base commit has no reports uploaded.
# Resulting in "missing base report"


# Illustration C
master P
pull    \ . . P
# Base and head commits passed CI and uploaded coverage to Codecov.
# Resulting in a beautiful comment being posted.

Next: Read about Comparing Commits.

Missing head commit

You will see an error stating No coverage uploaded for pull request head. when the pull request has:

  • not yet uploaded coverage results to Codecov;
  • or the uploaded reports are from failed CI builds.

Unknown Author

If your commit is showing author as "Unknown", here is how to fix it.

Your git provider (i.e. GitHub) is not returning the author id in the commit api result. This is because the email used to commit is not the same as your Github account.

Edit the user email found in your ~/.gitconfig:

	name = Your Name
	email = [email protected]  # make sure the email is the same you login to Github

No statuses or pull requests are posting

This issue is likely caused by the bot losing authentication to your project. Learn more Team Bot.

Empty Reports

To check if your uploaded report is empty (containing no coverage data) please download the reports by clicking Download in the build logs. Look for the file by searching the string # path=. Review each file to confirm if coverage was properly collected.

Updated 8 months ago

Error Reference

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.