Status Badges

Status pages are a way for users to display Codecov data on the README.md of a repository.

You can access Coverage Status Badges for your Repository by visiting the Badges & Graphs section of the Repository Configuration page in Codecov:

1261

📘

Coverage Badges for Flags & Components

You can create a badge relevant to a flag or a component by adding flag=<flag-name> or component=<component-name|component-id> after ...badge.svg? in the above.

Bundle Size Badges

codecov

If you use Bundle Analysis for tracking bundle size over time, you can also make a status badge to show your current bundle size. Currently, there is no interface in our app for generating these badges like for coverage badges, but you can construct the badge url manually:

https://codecov.io/<provider>/<owner>/<repo>(optional: /<branch-name>)/graph/bundle/<bundle-name>/badge.svg

For example:

https://codecov.io/github/codecov/gazebo/main/graph/bundle/gazebo-production-esm/badge.svg

Optionally, you can append a precision query parameter specifying how many decimal places you'd like in the badge. Valid values are 0, 1, and 2. 2 is the default value.

Here are examples wrapping the svg in a link for rendering in Markdown, HTML, or RST:

[![bundle size](https://codecov.io/github/codecov/gazebo/graph/bundle/gazebo-production-esm/badge.svg)](https://app.codecov.io/github/codecov/gazebo/bundles/main/gazebo-production-esm)
<a href="https://app.codecov.io/github/codecov/gazebo/bundles/main/gazebo-production-esm" >
  <img src="https://codecov.io/github/codecov/gazebo/graph/bundle/gazebo-production-esm/badge.svg" />
</a>
// RST
.. image:: https://codecov.io/github/codecov/gazebo/graph/bundle/gazebo-production-esm/badge.svg
:target: https://app.codecov.io/github/codecov/gazebo/bundles/main/gazebo-production-esm

Badges for Private Repositories

If you're trying to render a badge for a private repo, you will need to append the token query parameter to your badge svg URLs. You can find the value for this token by looking at the badge examples for your repository in the Codecov app (as pictured near top of this page).