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

Troubleshooting Guide

If you are having issues using Codecov, please check the steps below before reaching out to support.

Uploading Reports

  1. Be sure you are using the latest version of the uploader you are using
  2. Try the bash uploader.
  3. If uploading reports have started to fail recently, did the version of the uploader also change? If so, please contact support.
  4. Disable parts of the bash uploader that may not be relevant using the -X.
  5. If you are seeing a timeout issue, try adding retry logic to the curl command for the bash uploader (--retry 5 --connect-timeout 5)
  6. If you are seeing ‘There has been an unexpected error’ in the Codecov UI, try viewing the report uploaded to Codecov by using the -d or -q arguments). You can also check our error reference.
  7. If you are missing coverage on files, check that they exist in your coverage reports by viewing the Build tab. If they are there, you likely will need to apply path fixing.

Unexpected Coverage Changes

  1. Check that the commits tab of your pull request on matches with what you expect. Ensure that the parent and head commits have uploaded coverage to compare.
  2. Review the coverage reports in the Build tab. Ensure that the coverage reports are a supported coverage report format.
  3. Make sure your tests are idempotent and that they are all running.
  4. Validate your codecov.yml file.
  5. Check Unexpected Coverage Changes

Inaccessible Parts of the Codecov UI

  1. Clear your cookies and try logging back in.
  2. If you are using GitHub, switch to the GitHub App Integration
  3. If you cannot view private repositories, add the private scope as detailed in the Codecov UI.
  4. Re-sync your repositories by going to the appropriate code provider link and syncing at the bottom

Updated 2 months ago

Troubleshooting Guide

Suggested Edits are limited on API Reference Pages

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