Skip to main content

Getting a Salesforce org health check from Pipelines

Discover how to generate a Salesforce org health check in Gearset Pipelines for actionable insights into your org’s quality and security.

Written by Alec Short

To get a Salesforce org health check in Gearset, run a Code Reviews scan from the Org health tab of an environment in your pipeline. The org health scan checks the metadata in your Salesforce org against the Code Reviews rules. The results show your issues by severity, with an overall score from 0 (poor) to 100 (great).


Use this article to start an org health scan from Pipelines, find the results, and decide what to fix first.
​


What do I need before I run an org health scan?

Before you run an org health scan from Pipelines, check these three things:

  • You’re a team owner on your Gearset team.

  • You have a pipeline. The Org health tab shows only on the final environment in the pipeline.

  • You can log in to the Salesforce org for that environment. Code Reviews needs its own connection to the org, even if the org is already connected to Gearset.

If your team doesn’t have Code Reviews yet, your first org health scan starts a 30-day Code Reviews trial.
​

How do I run an org health scan from Pipelines?

To run an org health scan, follow these steps as a team owner.

  1. Open your pipeline in Gearset.

  2. Click the final environment in the pipeline.

  3. Click the Org health tab.

  4. Click Scan organization.

  5. Authorize Code Reviews to connect to your Salesforce org. Check that you log in to the org you want to scan.


​

The org health scan starts automatically after you authorize the org. You don’t need to keep the page open.
​

The first org health scan takes longer than later scans, because Code Reviews retrieves and analyzes all the metadata in the org.
​

Where do I see my org health scan results?

Org health scan results show in two places in Gearset.
​

In Pipelines. The Org health tab on the final environment shows your issue count by severity. After a second scan, the tab also shows whether you have more or fewer issues than the last scan.
​

On the Code reviews page. For the full results, click Code reviews in the left-hand menu, then select your org. See Branch health scans in Gearset for an explanation of each tab.
​

What do I do with my org health scan results?

Use the org health scan results to choose what to fix first, fix it, and then scan again.


Start on the Priorities tab. It groups your highest priority issues into four cards: biggest impact issues, quick wins, security risks, and Agentforce readiness.


Open an issue, then open the Explain tab in the sidebar. The Explain tab says why the issue matters and how to fix it.

Run a new scan from the Priorities tab to check your progress.
​

For how Code Reviews calculates the score, see What’s the Code Reviews score? How is it calculated?.

Did this answer your question?