> For the complete documentation index, see [llms.txt](https://docs.sonarsource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-subscription/subscription-plans.md).

# Subscription plans

SonarQube Cloud offers three subscription-based plans: Free, Team, and Enterprise, each with varying features and suitable for different team sizes.

SonarQube Cloud's [pricing model](https://www.sonarsource.com/plans-and-pricing/sonarcloud/) is subscription-based: each organization is assigned a subscription plan. Four different plans are available:

* Free plan, for small teams. Only basic analysis features are available.
* Team plan, if you want to benefit from advanced analysis features.
* Enterprise plan, for larger organizations and teams, and if you want to benefit from the enterprise-level hierarchy and from even more features.
* OSS (Open Source Software) plan, a free plan for open source organizations that offers unlimited access to branch analysis and pull request analysis. See [#oss-plan](#oss-plan "mention").

> **Warning:** The legacy paid plan will soon no longer be supported. We recommend that you migrate your legacy plan organization to the plan that meets your current and future needs. See [Changing your subscription plan](/sonarqube-cloud/administering-sonarcloud/managing-subscription/changing-plan.md).

For information about SonarQube Cloud's billing model, see the [Billing model](/sonarqube-cloud/administering-sonarcloud/managing-subscription/billing-model.md) page.

## Comparison table (Free, Team, and Enterprise) <a href="#comparison-table" id="comparison-table"></a>

Compare the products and features in the SonarQube Cloud Free, Team, and Enterprise plans.

### Products that need a separate subscription

These products are not included in any plan. Where available, each one needs its own subscription. SCA and Advanced SAST share a single Advanced Security subscription.

| Feature                                                             | Free          | Team                                              | Enterprise                                        | Note                                                                                                                                                                                                                                                     |
| ------------------------------------------------------------------- | ------------- | ------------------------------------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Software Composition Analysis (SCA)<sup>1</sup>                     | Not available | Separate subscription (Advanced Security product) | Separate subscription (Advanced Security product) | See [Introduction](/sonarqube-cloud/advanced-security/introduction.md#sca)                                                                                                                                                                               |
| Advanced SAST (Static Application Security Testing)<sup>1</sup>     | Not available | Separate subscription (Advanced Security product) | Separate subscription (Advanced Security product) | See [Introduction](/sonarqube-cloud/advanced-security/introduction.md#advanced-sast)                                                                                                                                                                     |
| Hunter Agent<sup>1</sup>                                            | Not available | Not available                                     | Separate subscription                             | To trial or purchase Hunter Agent, contact [our Sales team](https://www.sonarsource.com/products/sonarqube/contact-sales/). See [Hunter Agent](/agent-centric-development-cycle/in-your-long-living-branches-the-code-maintenance-loop/hunter-agent.md). |
| Remediation Agent (on GitHub, GitLab, and Azure DevOps)<sup>2</sup> | Not available | Separate subscription (annual Team plan only)     | Separate subscription                             | See [Administer the Remediation Agent](/sonarqube-cloud/administering-sonarcloud/ai-features/administer-remediation-agent.md)                                                                                                                            |
| Sonar Vortex context<sup>2</sup>                                    | Not available | Separate subscription (annual Team plan only)     | Separate subscription                             | See [Sonar Vortex context](/agent-centric-development-cycle/inside-your-agent-the-agentic-loop/sonar-vortex-context.md)                                                                                                                                  |
| Sonar Vortex analysis<sup>2</sup>                                   | Not available | Separate subscription (annual Team plan only)     | Separate subscription                             | See [Sonar Vortex analysis](/agent-centric-development-cycle/inside-your-agent-the-agentic-loop/sonar-vortex-analysis.md)                                                                                                                                |

1\) These products require a separate subscription and are not included in your Team or Enterprise plan. To subscribe, see [Signing up for a plan or product](/sonarqube-cloud/administering-sonarcloud/managing-subscription/signing-up-for-plan.md). If you have a monthly Team plan, you can add Advanced Security directly from SonarQube Cloud. If you have an annual Team plan or an Enterprise plan, contact [our Sales team](https://www.sonarsource.com/products/sonarqube/contact-sales/) to trial or purchase Advanced Security. See [Subscribing to the Advanced Security product](/sonarqube-cloud/administering-sonarcloud/managing-subscription/signing-up-for-plan.md#advanced-security).

2\) Sonar Vortex includes its context and analysis features. Sonar Vortex and the Remediation Agent each require a separate subscription in addition to an annual Team plan or an Enterprise plan. To trial or purchase either product, see [Subscribing to Sonar Vortex and the Remediation Agent](/sonarqube-cloud/administering-sonarcloud/managing-subscription/signing-up-for-plan.md#agent-products). For Vortex prerequisites and setup, see [Sonar Vortex](/sonarqube-cloud/administering-sonarcloud/ai-features/sonar-vortex.md). To use the Remediation Agent after you subscribe, an organization admin enables it under *Your organization* > **Administration** > **AI capabilities** > **Remediation Agent**.

### Features included in your plan

| Category                    | Feature                                                                   | Free                                         | Team           | Enterprise | Note                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------- | ------------------------------------------------------------------------- | -------------------------------------------- | -------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| General                     | Analysis of public projects: unlimited number of projects                 | Included                                     | Included       | Included   | See [Organization's projects](/sonarqube-cloud/administering-sonarcloud/about-sonarqube-cloud-solution/resources-structure/projects.md)                                                                                                                                                                                                               |
| General                     | Analysis of private projects                                              | Up to 50k LOC                                | Up to 1.9M LOC | Unlimited  | The maximum number of lines of code (LOC) in a plan restricts the analysis of private projects in your organization or enterprise. See [#loc-based-pricing](#loc-based-pricing "mention").                                                                                                                                                            |
| General                     | Maximum number of organization members                                    | 5                                            | Unlimited      | Unlimited  |                                                                                                                                                                                                                                                                                                                                                       |
| General                     | Enterprise-level hierarchy                                                | Not available                                | Not available  | Included   | You can group several organizations into an enterprise.                                                                                                                                                                                                                                                                                               |
| General                     | DevOps platform binding (GitHub, Bitbucket Cloud, GitLab, Azure DevOps)   | Included                                     | Included       | Included   |                                                                                                                                                                                                                                                                                                                                                       |
| General                     | User authentication                                                       | Included                                     | Included       | Included   | See [Default authentication through DevOps platform](/sonarqube-cloud/administering-sonarcloud/about-sonarqube-cloud-solution/user-management/devops-platform-authentication.md).                                                                                                                                                                     |
| General                     | Organization onboarding from multiple DevOps platforms (except Bitbucket) | Not available                                | Not available  | Included   | As an enterprise member, you can import a DevOps organization using any of your DevOps accounts or SSO account (except for a Bitbucket workspace which can only be imported using a Bitbucket account).                                                                                                                                               |
| General                     | Automatic GitHub repo import                                              | Included                                     | Included       | Included   | See [Auto-importing new repositories](/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/auto-import-new-repos.md)                                                                                                                                                                                                   |
| General                     | Bulk import of all repositories                                           | Included                                     | Included       | Included   | See [Creating your project](/sonarqube-cloud/managing-your-projects/administering-your-projects/setting-up-project.md#bulk-import)                                                                                                                                                                                                                    |
| Code analysis               | Branch analysis                                                           | Only main branch analysis                    | Included       | Included   | See [Branch analysis](/sonarqube-cloud/analyzing-source-code/branch-analysis/branch-analysis.md)                                                                                                                                                                                                                                                      |
| Code analysis               | Pull request analysis                                                     | Only if the target branch is the main branch | Included       | Included   | See [Pull request analysis](/sonarqube-cloud/analyzing-source-code/pull-request-analysis.md)                                                                                                                                                                                                                                                          |
| Code analysis               | Custom quality profiles                                                   | Not available                                | Included       | Included   | See [Understanding quality profiles](/sonarqube-cloud/standards/managing-quality-profiles/understanding-quality-profiles.md)                                                                                                                                                                                                                          |
| Code analysis               | Custom quality gates                                                      | Not available                                | Included       | Included   | See [Understanding quality gates](/sonarqube-cloud/standards/managing-quality-gates/introduction-to-quality-gates.md)                                                                                                                                                                                                                                 |
| Code analysis               | Architecture                                                              | Not available                                | Included       | Included   | Visualize current and intended architecture, and raise architecture problems. See [Architecture analysis](/sonarqube-cloud/architecture-analysis.md).                                                                                                                                                                                                 |
| Code analysis               | Enterprise architecture                                                   | Not available                                | Not available  | Included   | Cross-project visualization, architecture patterns, system components, and SDKs. In open beta. See [Enterprise architecture](/sonarqube-cloud/architecture-analysis/enterprise-architecture.md).                                                                                                                                                      |
| Code analysis               | Project coverage                                                          | Included                                     | Included       | Included   | Shows whether every repository is connected, imported, and analyzed. See [Project coverage](/sonarqube-cloud/quickstart-guides/project-coverage.md).                                                                                                                                                                                                  |
| Code analysis               | Report of security alerts in GitHub                                       | Not available                                | Not available  | Included   | SonarQube Cloud automatically provides feedback about security vulnerabilities inside the GitHub interface itself. See [Issues reported in GitHub](/sonarqube-cloud/managing-your-projects/issues/in-devops-platform/github.md#code-scanning-alerts).                                                                                                 |
| AI code analysis            | AI Code Assurance                                                         | Included                                     | Included       | Included   | See [Set your AI standards](/sonarqube-cloud/standards/ai-code-assurance/overview.md)                                                                                                                                                                                                                                                                 |
| AI code analysis            | Sonar way for agentic AI quality gate                                     | Included                                     | Included       | Included   | See [Quality gate for agentic AI](/sonarqube-cloud/standards/ai-code-assurance/quality-gate-for-agentic-ai.md)                                                                                                                                                                                                                                        |
| AI-powered code remediation | AI CodeFix                                                                | Not available                                | Included       | Included   | See [Enable AI CodeFix](/sonarqube-cloud/administering-sonarcloud/ai-features/enable-ai-codefix.md)                                                                                                                                                                                                                                                   |
| Agentic development         | Cloud-hosted MCP server                                                   | Included                                     | Included       | Included   | See the [SonarQube Cloud-hosted](/sonarqube-mcp-server/setup/sonarqube-cloud-hosted.md) page                                                                                                                                                                                                                                                          |
| Agentic development         | Agent apps for GitHub                                                     | Included                                     | Included       | Included   | Requires access to GitHub agent apps                                                                                                                                                                                                                                                                                                                  |
| Management reporting        | Portfolios                                                                | Not available                                | Not available  | Included   | See [Viewing portfolios](/sonarqube-cloud/managing-portfolios/viewing-portfolios.md)                                                                                                                                                                                                                                                                  |
| Management reporting        | Dashboards                                                                | Not available                                | Not available  | Included   | See [Project dashboards](/sonarqube-cloud/managing-your-projects/dashboards.md) and [Portfolio dashboards](/sonarqube-cloud/managing-portfolios/portfolio-dashboards.md)                                                                                                                                                                              |
| Management reporting        | Compliance reports                                                        | Not available                                | Not available  | Included   | See [Project compliance reports](/sonarqube-cloud/getting-started-with-enterprise/viewing-enterprise-reports/project-compliance-reports.md)                                                                                                                                                                                                           |
| Management reporting        | Project PDF reports                                                       | Not available                                | Not available  | Included   | See [Viewing project PDF reports](/sonarqube-cloud/getting-started-with-enterprise/viewing-enterprise-reports/project-pdf-reports.md)                                                                                                                                                                                                                 |
| Integrations                | Jira Cloud                                                                | Not available                                | Included       | Included   | See [Jira Cloud](/sonarqube-cloud/discovering-sonarcloud/integrations/jira-cloud.md)                                                                                                                                                                                                                                                                  |
| Integrations                | Slack                                                                     | Included                                     | Included       | Included   | See [Slack](/sonarqube-cloud/discovering-sonarcloud/integrations/integration-overview.md)                                                                                                                                                                                                                                                             |
| Integrations                | JFrog Evidence Collection                                                 | Not available                                | Not available  | Included   | See [JFrog Evidence Collection](/sonarqube-cloud/discovering-sonarcloud/integrations/jfrog.md)                                                                                                                                                                                                                                                        |
| Integrations                | Webhooks                                                                  | Not available                                | Included       | Included   | SonarQube Cloud supports the configuration of webhooks, allowing you to send automatic notifications to external services of analysis activity. See [Webhooks](/sonarqube-cloud/discovering-sonarcloud/integrations/webhooks.md).                                                                                                                     |
| Enterprise security         | SSO authentication (SAML and OIDC)                                        | Not available                                | Not available  | Included   | See [About SSO and provisioning](/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/about.md#sso)                                                                                                                                                                                                                     |
| Enterprise security         | Auto-provisioning (SCIM)                                                  | Not available                                | Not available  | Included   | See [About SSO and provisioning](/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/about.md#scim)                                                                                                                                                                                                                    |
| Enterprise security         | Scoped Organization Token (SOT)                                           | Not available                                | Included       | Included   | See [Scoped Organization Tokens](/sonarqube-cloud/administering-sonarcloud/managing-organization/scoped-organization-tokens.md)                                                                                                                                                                                                                       |
| Enterprise security         | Audit logs                                                                | Not available                                | Not available  | Included   | See [Audit logs](/sonarqube-cloud/administering-sonarcloud/enterprise-security/audit-logs.md)                                                                                                                                                                                                                                                         |
| Enterprise security         | IP allow list restriction                                                 | Not available                                | Not available  | Included   | See [IP allow lists](/sonarqube-cloud/administering-sonarcloud/enterprise-security/ip-allow-lists.md)                                                                                                                                                                                                                                                 |
| Administration              | Groups                                                                    | Not available                                | Included       | Included   | As an organization admin, you can manage custom groups and change the permissions of any group. See [User group concept](/sonarqube-cloud/administering-sonarcloud/about-sonarqube-cloud-solution/user-management/user-group-concept.md)                                                                                                              |
| Administration              | Permission templates                                                      | Not available                                | Included       | Included   | As an organization admin, you can use permissions templates to manage the default permissions applying to new projects. See [Using permission templates](/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/manage-project-permissions/templates.md)                                                                 |
| Administration              | Organization-wide project configurations                                  | Not available                                | Not available  | Included   | As an organization admin, you can define the long-lived branch name pattern, the analysis scope adjustment, and the automatic analysis disabling for new projects at the organization level. See the [Performing global analysis setup](/sonarqube-cloud/administering-sonarcloud/managing-organization/setting-config-at-org-level.md) instructions. |
| Administration              | Projects Management page                                                  | Not available                                | Not available  | Included   | As an organization admin, you can manage the projects of your organization on a centralized page: the Projects Management page. See [Using Projects Management page](/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/projects-management-page.md)                                                                 |
| Administration              | Delegation of the quality profile management permission                   | Not available                                | Not available  | Included   | With the Administer Quality Profiles permission, you can authorize users or groups to manage a specific custom quality profile. See [Granting permissions to users](/sonarqube-cloud/standards/managing-quality-profiles/authorizing-other-users-to-manage-quality-profile.md)                                                                        |

> **Note:** ABAP, APEX, COBOL, JCL, PL/I, and RPG languages are only supported with the Enterprise plan. See the [Supported languages](/sonarqube-cloud/discovering-sonarcloud/overview.md) page for more information.

## OSS plan (SonarQube for OSS) <a href="#oss-plan" id="oss-plan"></a>

If you're part of an open source organization, you may be interested in the OSS plan. It lets you analyze an unlimited number of public repositories but *no private projects*. Advanced features are also available, as described in the table below. Note that all legacy free organizations have been moved to the OSS plan. To sign up, see [Signing up for a plan or product](/sonarqube-cloud/administering-sonarcloud/managing-subscription/signing-up-for-plan.md#oss). To move your OSS organization to Free, see the [Changing your subscription plan](/sonarqube-cloud/administering-sonarcloud/managing-subscription/changing-plan.md#moving-from-oss-to-free) page.

<table><thead><tr><th width="211">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Maximum number of organization members</td><td>Unlimited.</td></tr><tr><td><strong>Code analysis</strong></td><td><br></td></tr><tr><td>Languages</td><td>All languages supported in the Team plan. See <a data-mention href="/sonarqube-cloud/discovering-sonarcloud/overview.md">Supported languages</a>.</td></tr><tr><td>Branch analysis</td><td>Unlimited.<br>For more information about the feature, see <a data-mention href="/sonarqube-cloud/analyzing-source-code/branch-analysis/branch-analysis.md">Branch analysis</a>.</td></tr><tr><td>Pull request analysis</td><td><p>Unlimited.</p><p>For more information about the feature, see <a data-mention href="/sonarqube-cloud/analyzing-source-code/pull-request-analysis.md">Pull request analysis</a>.</p></td></tr><tr><td>Custom quality profiles</td><td>See <a data-mention href="/sonarqube-cloud/standards/managing-quality-profiles/understanding-quality-profiles.md">Understanding quality profiles</a>.</td></tr><tr><td>Custom quality gates</td><td>See <a data-mention href="/sonarqube-cloud/standards/managing-quality-gates/introduction-to-quality-gates.md">Understanding quality gates</a>.</td></tr><tr><td>Advanced SAST (Static Application Security Testing)</td><td>See <a data-mention href="/sonarqube-cloud/advanced-security/introduction.md#advanced-sast">Introduction</a>.</td></tr><tr><td><strong>Integrations</strong></td><td></td></tr><tr><td>Webhooks</td><td>SonarQube Cloud supports the configuration of webhooks, allowing you to send automatic notifications to external services of analysis activity. See <a data-mention href="/sonarqube-cloud/discovering-sonarcloud/integrations/webhooks.md">Webhooks</a>.</td></tr><tr><td><strong>User administration</strong></td><td><br></td></tr><tr><td>Projects Management page</td><td>As an organization admin, you can manage the projects of your organization on a centralized page: the Projects Management page. See <a data-mention href="/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/projects-management-page.md">Using Projects Management page</a>.</td></tr><tr><td>GitHub member synchronization</td><td>SonarQube Cloud automatically synchronizes organization members with GitHub.com. This feature is not supported for GHE.com or GHES. See <a data-mention href="/sonarqube-cloud/administering-sonarcloud/about-sonarqube-cloud-solution/user-management/github-member-synchronization.md">GitHub member synchronization</a>.</td></tr><tr><td>DevOps platform authentication</td><td>See <a data-mention href="/sonarqube-cloud/administering-sonarcloud/about-sonarqube-cloud-solution/user-management/devops-platform-authentication.md">Default authentication through DevOps platform</a>.</td></tr><tr><td>Groups</td><td>As an organization admin, you can manage custom groups and change the permissions of any group. See <a data-mention href="/sonarqube-cloud/administering-sonarcloud/about-sonarqube-cloud-solution/user-management/user-group-concept.md">User group concept</a>.</td></tr><tr><td>Permission templates</td><td>As an organization admin, you can use permissions templates to manage the default permissions applying to new projects. See <a data-mention href="/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/manage-project-permissions/templates.md">Using permission templates</a>.</td></tr></tbody></table>

## LOC-based pricing <a href="#loc-based-pricing" id="loc-based-pricing"></a>

Your subscription plan determines the maximum number of private Lines of Code (LOC) you're permitted to analyze, in your organization (for a Free or Team plan) or in your enterprise (for an Enterprise plan):

* Free: You can analyze up to 50k LOC in your organization.
* Team: You can choose a LOC between 100k and 1.9M for your organization. If you need more than 1.9M LOC, see the Enterprise plan.
* Enterprise: You can choose any LOC you want for your entire enterprise. By default, the enterprise LOC is shared by all organizations in the enterprise (Shared LOC). You can also allocate an individual LOC limit to one or more organizations within the enterprise (Allocated LOC). The other organizations will share the remaining LOC limit. For more information, see [Managing the lines of code within your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-lines-of-code-within-your-enterprise.md#about-enterprise-loc-limit).

> **Warning:** You need to ensure that your choice of plan covers all of the LOCs you want to analyze; otherwise, you may not be able to onboard all of your organization's projects.

### LOC limit management <a href="#loc-limit-management" id="loc-limit-management"></a>

You cannot exceed your LOC limit in SonarQube Cloud.

* **Organization LOC limit**: applies to Free and Team plans, and to individual organizations with an Allocated LOC limit under an Enterprise plan. You'll receive a notification as you approach the limit, advising you to upgrade your plan or reduce your projects' LOC.
* **Enterprise-wide LOC limit**: applies to the Shared LOC pool across an Enterprise plan. This notification is not currently supported.

You can analyze the same code as often as you like. However, if you try to analyze more LOC than is allowed under your current subscription, SonarQube Cloud will not perform the analysis, and you'll also receive an error message clearly explaining the reason for this.

<details>

<summary>LOC limit application example</summary>

Your organization has a 20,000 LOC license.

When you analyze a project that contains 10,000 lines of code (LOC) once, you've used 10,000 LOC from your organization's license. If you analyze the same project 20 more times, you'll still have only used 10,000 LOC from the license.

However, if you then try to analyze a different project that has 15,000 LOC, you'll exceed the 20,000 LOC limit of your organization's license and receive an error message.

</details>

### Used LOC calculation <a href="#used-loc-calculation" id="used-loc-calculation"></a>

The LOC used by an organization is calculated by adding up the LOC of each private project analyzed for your organization. The calculation is a measure of the sum of the LOC of the largest long-lived branches for all your projects. It's not a measure of the new code analyzed in a given billing cycle. During calculation, the following are excluded from your LOC count:

* Test code.
* Files excluded from analysis.
* Code in unsupported languages.
* Comments or blank lines.

<details>

<summary>Organization LOC calculation example</summary>

Your organization has two private projects:

* Project-1 has 500 lines of code on its main branch and 400 on a secondary long-lived branch: its LOC is 500.
* Project-2 has 0 lines of code on its main branch (provisioned but never analyzed) and 200 on a secondary long-lived branch: its LOC is 200.
* The total LOC for your organization is 500 + 200 = 700.

</details>

## Related pages <a href="#related-pages" id="related-pages"></a>

* [Billing model](/sonarqube-cloud/administering-sonarcloud/managing-subscription/billing-model.md)
* [Signing up for a plan or product](/sonarqube-cloud/administering-sonarcloud/managing-subscription/signing-up-for-plan.md)
* [Getting started with Enterprise](/sonarqube-cloud/getting-started-with-enterprise.md)
* [Changing your subscription plan](/sonarqube-cloud/administering-sonarcloud/managing-subscription/changing-plan.md)
* [Updating billing or payment details](/sonarqube-cloud/administering-sonarcloud/managing-subscription/updating-billing-payment-details.md)
* [Viewing billing or usage information](/sonarqube-cloud/administering-sonarcloud/managing-subscription/viewing-billing-and-usage.md)
* [Viewing taxes and invoices](/sonarqube-cloud/administering-sonarcloud/managing-subscription/viewing-taxes-and-invoices.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-subscription/subscription-plans.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
