Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
0f06b2c
moving all report pages to one single place in the navbar
claudiacodacy Feb 19, 2026
8c137ed
fix build
claudiacodacy Feb 19, 2026
3f1d93a
fixing repositories page
claudiacodacy Feb 19, 2026
77cbf52
Update docs/faq/code-analysis/which-metrics-does-codacy-calculate.md
claudiacodacy Feb 19, 2026
89cb2e9
fix routes
claudiacodacy Feb 19, 2026
733db4c
Merge branch 'master' into new-dashboards
claudiacodacy Feb 19, 2026
efd04e4
fix table
claudiacodacy Feb 19, 2026
2eaac43
drafting organization overview doc
claudiacodacy Feb 19, 2026
b69ded3
adding sections, making anchors work
claudiacodacy Feb 19, 2026
682086d
clean-up + image placeholders
claudiacodacy Feb 19, 2026
80d03fa
adding images
claudiacodacy Feb 19, 2026
c68e045
Update docs/organizations/reporting/organization-overview.md
claudiacodacy Feb 19, 2026
6ad8833
Update docs/organizations/reporting/organization-overview.md
claudiacodacy Feb 19, 2026
0003e3d
add health image
claudiacodacy Feb 19, 2026
076ed90
Update docs/organizations/reporting/organization-overview.md
claudiacodacy Feb 19, 2026
f1c9388
Update docs/organizations/reporting/organization-overview.md
claudiacodacy Feb 19, 2026
002e32a
remove overall chart
claudiacodacy Feb 20, 2026
8c6d571
Duplication + Complexity descriptions
claudiacodacy Feb 20, 2026
e7a8727
fixing url
claudiacodacy Feb 20, 2026
8439800
add coverage section
claudiacodacy Feb 20, 2026
6ce4f7d
Merge branch 'master' into coverage-and-overview-metrics
claudiacodacy Feb 20, 2026
5cbf748
Apply suggestions from codacy code review
claudiacodacy Feb 20, 2026
881184f
download mention
claudiacodacy Feb 20, 2026
d6056bd
fix url
claudiacodacy Feb 20, 2026
296fa85
chatgpt review
claudiacodacy Feb 20, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
132 changes: 109 additions & 23 deletions docs/organizations/reporting/organization-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,49 +4,69 @@

# Organization overview

The **Organization overview** provides an overview of the repositories belonging to your Git provider organization that you [follow on Codacy](../managing-repositories.md). Here you can compare their statuses and check for items that require your attention.
Codacy gives you high-level visibility into your organization's code quality, security posture, AI risks, and usage and configuration metrics. In the **Organization overview**, you can see these metrics at a glance.

The **Organization overview** summarizes the repositories belonging to your Git provider organization that you [follow on Codacy](../managing-repositories.md). Here you can compare their statuses and check for items that require your attention.

To access your Organization overview, select an organization from the top navigation bar and select **Overview** on the left navigation sidebar.

Use the drop-down list at the top of the page to filter the information displayed on all dashboard areas based on the repositories that you select. For example, you can use the filter to monitor the quality of the repositories maintained by specific teams or that include certain programming languages, or to ignore legacy repositories that are no longer maintained. The selected repositories are stored in your browser so that the same filter is applied between your visits to the Organization overview page.
![Image of the Organization Overview on the Overview tab](./images/organization-overview.png)

On the Organization overview you have the following areas to help you monitor your repositories:
The Organization overview contains the following tabs:

- [Overall quality chart](#overall-quality-chart)
- [Last updated repositories](#last-updated-repositories)
- [Issues metrics](issues-metrics.md)
- [Overview](#overview)
- [Open issues](./issues-metrics.md)
- [Grade](#grade)
- [Complexity](#complexity)
- [Duplication](#duplication)
- [Coverage](#coverage)
- [Codacy usage](./codacy-usage.md)
- [AI Risk Hub](./ai-risk-hub.md)

On this page, you can also see the **Organization setup** area, which provides you with a checklist of items that you should complete to ensure that your organization is set up correctly and that you're getting the most out of Codacy.
<div id="overview-filters">Use the filters at the top of the page to filter all dashboard information by repositories or segments. For example, use filters to monitor repositories maintained by specific teams or repositories using specific programming languages, or to ignore legacy repositories that are no longer maintained. Your filter selection is stored in your browser, so your view is preserved between visits.</div>

The following sections provide a detailed description of the repository-related dashboard areas.
This page covers the Overview, Grade, Complexity, Duplication, and Coverage sections.

{% include-markdown "../../assets/includes/dashboard-api-report-note.md" %}

## Overall quality chart
## Overview

The **Overall quality** chart compares the repositories that you follow regarding [grade](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#grade), [issues](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#issues), [complex files](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#complexity), [duplication](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#duplication), and [code coverage](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#code-coverage). Each tab displays the average value for the corresponding metric for the last updated repositories.
On the Organization overview page, you have the following areas to help you monitor your repositories:

!!! important
- The overall quality chart calculates metrics and displays data only for the **repositories that you follow** on Codacy. This means that depending on their list of followed repositories, two users can see different results on this chart.
- [Code health and security](#code-health-and-security)
- [Last updated repositories](#last-updated-repositories)

- The overall quality chart displays information for **at most the last 100 updated repositories**.
On this page, you can also see the **Organization setup** area, which provides you with a checklist of items that you should complete to ensure that your organization is set up correctly and that you're getting the most out of Codacy.

<div id="overall-quality-chart"></div>
### Code health and security
Comment on lines +41 to +42
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚪ LOW RISK

Suggestion: Instead of using an empty div for the anchor, you can attach the ID directly to the heading if your documentation engine supports it. This is generally cleaner and less prone to rendering issues.

This might be a simple fix:

Suggested change
<div id="overall-quality-chart"></div>
### Code health and security
### Code health and security {#overall-quality-chart}


![Image of Code health and security section](./images/organization-overview-code-health-security.png)

![Overall quality chart](images/organization-overview-overall-quality.png)
The **Code health and security** area provides a snapshot of your organization and key hotspots. Here, you can see at a glance open issues, new vs. fixed issues, prevented issues, and complexity, duplication, coverage, and security metrics. You can click any metric to see more details.

Check failure on line 46 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'hotspots'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'hotspots'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 46, "column": 88}}}, "severity": "ERROR"}

Check failure on line 46 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'hotspots'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'hotspots'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 46, "column": 88}}}, "severity": "ERROR"}

- Hover the mouse pointer over the bars to see the metrics for the corresponding repositories.
- Click the bars to navigate directly to the corresponding repository.
Some of these metrics depend on your billing plan and are calculated differently. For details, see the following table:

If you have over 8 repositories, the chart displays your repositories grouped by grade or percentage intervals. Click the bars to see and navigate directly to the corresponding repositories.
| Metric | Availability | How it is calculated |

Check failure on line 50 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'it's' instead of 'it is'. Raw Output: {"message": "[Microsoft.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 50, "column": 31}}}, "severity": "ERROR"}

Check failure on line 50 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'it's' instead of 'it is'. Raw Output: {"message": "[Microsoft.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 50, "column": 31}}}, "severity": "ERROR"}
| ------ | ------------ | -------------------- |
| Open issues, New and Fixed issues, and Prevented issues | Paid plans | [More details](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#issues) |
| Grade | Open source and trial plans | [More details](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#grade) |
| Complexity | All plans | [More details](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#complexity) |
| Duplication | All plans | [More details](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#duplication) |
| Coverage | All plans <a href="#coverage-note"><sup>1</sup></a> | [More details](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#code-coverage) |
| Security | All plans | [More details](../managing-security-and-risk.md) |

![Overall quality chart with grouped repositories](images/organization-overview-overall-quality-grouped.png)

!!! tip
If you don't have coverage set up for any of your repositories yet, the coverage tab provides you with instructions on [how to add coverage for your repositories](../../coverage-reporter/index.md).
!!! important
- The overall quality chart calculates metrics and displays data only for the **repositories that you follow** on Codacy. This means that depending on their list of followed repositories, two users can see different results on this chart.

- Metrics like grade, complexity, duplication, and coverage (on free plans) represent **at most the last 100 updated repositories**.

<sup><span id="coverage-note">1</span></sup>: Coverage metrics are calculated differently for paid plans and for open source and trial plans. [Learn more](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#code-coverage).

## Last updated repositories
### Last updated repositories

The **Last updated repositories** list displays the last updated repositories, sorted by reverse date of the last update.
The **Last updated repositories** list displays the last updated repositories, sorted by reverse date of the last update.

![Last updated repositories](images/organization-overview-repositories-last-updated.png)

Expand All @@ -57,8 +77,74 @@
- **GitLab:** date when the project was last updated (value of `last_activity_at` from the [GitLab Groups API](https://docs.gitlab.com/ee/api/groups.html)). Note that this value is only updated [at most once per hour](https://gitlab.com/gitlab-org/gitlab/-/issues/20952)).
- **Bitbucket:** date when the repository was last updated (value of `updated_on` from the [Bitbucket Repositories API](https://developer.atlassian.com/cloud/bitbucket/rest/api-group-repositories/#api-group-repositories)). **On Bitbucket Server** Codacy can't obtain this information and the list displays the repositories in alphabetical order.

## See also
## Grade

![Image of the Grade tab](./images/organization-overview-grade.png)

The **Grade** tab gives you visibility into grade distribution across your repositories. From this tab, you can identify the repositories with the highest risk by selecting a grade in the distribution chart.

To learn more about how grades are calculated [see how metrics are calculated](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#grade).

!!! important
Grade metrics are based **at most on the last 100 updated repositories**.

## Complexity

![Image of the Complexity tab](./images/organization-overview-complexity.png)

Complexity allows you to understand which repositories are at risk of having code that is more difficult to test and more likely to have defects.

Check failure on line 95 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'that's' instead of 'that is'. Raw Output: {"message": "[Microsoft.Contractions] Use 'that's' instead of 'that is'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 95, "column": 83}}}, "severity": "ERROR"}

Check failure on line 95 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'that's' instead of 'that is'. Raw Output: {"message": "[Microsoft.Contractions] Use 'that's' instead of 'that is'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 95, "column": 83}}}, "severity": "ERROR"}

In this tab, you can understand your organization's complexity status (based on the number of complex files) and how repositories compare against their [goals](../../repositories-configure/adjusting-quality-goals.md). A file is considered complex if its cyclomatic complexity value is higher than the goal defined at repository level. To learn more, see [how metrics are calculated](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#complexity).

This panel shows, from the top 100 most recently updated repositories, which repositories are above goal, below goal, or have no goal. Because complexity is better when lower, repositories above goal are highlighted so you can review and act on them.

At the bottom of the tab, the complex files distribution helps you understand which files are complex because they are above goal, below goal, or in repositories without a goal. Files are not filterable, while repository goal distributions are.

Check failure on line 101 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'aren't' instead of 'are not'. Raw Output: {"message": "[Microsoft.Contractions] Use 'aren't' instead of 'are not'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 101, "column": 185}}}, "severity": "ERROR"}

Check failure on line 101 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'they're' instead of 'they are'. Raw Output: {"message": "[Microsoft.Contractions] Use 'they're' instead of 'they are'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 101, "column": 111}}}, "severity": "ERROR"}

Check failure on line 101 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'aren't' instead of 'are not'. Raw Output: {"message": "[Microsoft.Contractions] Use 'aren't' instead of 'are not'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 101, "column": 185}}}, "severity": "ERROR"}

Check failure on line 101 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Microsoft.Contractions] Use 'they're' instead of 'they are'. Raw Output: {"message": "[Microsoft.Contractions] Use 'they're' instead of 'they are'.", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 101, "column": 111}}}, "severity": "ERROR"}

!!! important
Complexity metrics are based **at most on the last 100 updated repositories**.

## Duplication
![Image of the Duplication tab](./images/organization-overview-duplication.png)

Duplication allows you to check if sequences of duplicate code exist in at least two different places of the source code of your repository.

In this tab, you can see your average duplication and check which repositories are above goal, below goal, or without configured [goals](../../repositories-configure/adjusting-quality-goals.md).

To learn more about duplication metrics, see [how duplication is calculated](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#duplication).

!!! important
Duplication metrics are based **at most on the last 100 updated repositories**.


## Coverage

![Image of the Coverage tab](./images/organization-overview-coverage.png)

The **Coverage** tab provides organization-level visibility into your coverage status. Strong coverage helps protect your code and reduce the risk of regressions when code changes.

!!! important
The Coverage tab has two modes:
- On trial and open source plans, you can see the average repository coverage across the 100 most recently updated repositories. This includes visibility into which repositories are above goal, below goal, or without a goal, similar to the Duplication and Complexity tabs.
- On paid plans, the dashboard removes the 100-repository limitation and provides additional metrics to help you prioritize improvements. This is the mode covered in this page.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚪ LOW RISK

Suggestion: To avoid confusion for users on free plans, consider specifying that the detailed metric descriptions in the following table/list apply specifically to the paid plan version.

This might be a simple fix:

Suggested change
- On paid plans, the dashboard removes the 100-repository limitation and provides additional metrics to help you prioritize improvements. This is the mode covered in this page.
- On paid plans, the dashboard removes the 100-repository limitation and provides additional metrics to help you prioritize improvements. This is the mode described in the following section.


To understand better how these metrics are calculated, [learn more](../../faq/code-analysis/which-metrics-does-codacy-calculate.md#code-coverage).

The Coverage tab is based on two key metrics:

- **Covered lines**: number of covered lines reported into Codacy;
- **Coverable lines**: number of lines that can be covered based on your coverage reports.

These metrics are the basis of all components in this dashboard:

| Metric | Description |
| ------ | ----------- |
| **Coverage** | _coveredLines / coverableLines_ <br/>Aggregation of all covered lines divided by all coverable lines across all repositories (or your filter selection, see [filters](#overview-filters)). This metric only includes repositories reporting coverage. |

Check failure on line 141 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'coverableLines'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'coverableLines'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 141, "column": 34}}}, "severity": "ERROR"}

Check failure on line 141 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'coveredLines'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'coveredLines'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 141, "column": 19}}}, "severity": "ERROR"}

Check failure on line 141 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'coverableLines'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'coverableLines'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 141, "column": 34}}}, "severity": "ERROR"}

Check failure on line 141 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'coveredLines'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'coveredLines'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 141, "column": 19}}}, "severity": "ERROR"}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚪ LOW RISK

The formula variables contain underscores which may cause the text to render as italics depending on the Markdown parser.

This might be a simple fix:

Suggested change
| **Coverage** | _coveredLines / coverableLines_ <br/>Aggregation of all covered lines divided by all coverable lines across all repositories (or your filter selection, see [filters](#overview-filters)). This metric only includes repositories reporting coverage. |
**Coverage** | `coveredLines / coverableLines` <br/>Aggregation of all covered lines divided by all coverable lines across all repositories (or your filter selection, see [filters](#overview-filters)). This metric only includes repositories reporting coverage. |

| **Repositories reporting coverage** | Repositories that have coverage based on the latest merged pull request. For example, if the latest merged pull request reported coverage metrics to Codacy, that repository is counted as reporting coverage. |
| **Coverage trend** | Trend over time for covered lines, uncovered lines, and organization coverage (or your filter selection, see [filters](#overview-filters)). You can select different time ranges and granularities, and select a date to see which repositories changed most in that period. |

Check failure on line 143 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'granularities'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'granularities'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 143, "column": 205}}}, "severity": "ERROR"}

Check failure on line 143 in docs/organizations/reporting/organization-overview.md

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [Vale.Spelling] Did you really mean 'granularities'? Raw Output: {"message": "[Vale.Spelling] Did you really mean 'granularities'?", "location": {"path": "docs/organizations/reporting/organization-overview.md", "range": {"start": {"line": 143, "column": 205}}}, "severity": "ERROR"}

You can download data from each chart using the ellipsis icon in the top-right corner and export values in JSON or CSV format.

## See also
- [Which metrics does Codacy calculate?](../../faq/code-analysis/which-metrics-does-codacy-calculate.md)
- [Using the Codacy API to obtain current issues in repositories](../../codacy-api/examples/obtaining-current-issues-in-repositories.md)
- [Using the Codacy API to obtain code quality metrics for files](../../codacy-api/examples/obtaining-code-quality-metrics-for-files.md)
Loading