> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qodo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# View cross-repository conflicts in your findings

> Learn how cross-repository conflict findings are generated by Qodo's cross-repository code review and how they flag breaking changes against related repositories.

<div style={{ display: "flex", alignItems: "center", gap: "6px" }}>
  <Badge color="outline-purple" size="sm" shape="pill">Beta</Badge>
</div>

Cross-repository conflicts are findings generated by Qodo's cross-repository code review that flag a change in a pull request that would break a related repository.

## How cross-repository conflicts are generated

Cross-repository conflicts are generated by Qodo's **cross-repository code review**, which reviews pull requests in repositories that have a defined relationship with other repositories.

When a pull request modifies a component covered by a relationship, such as a shared library, an API contract, or a database schema, the agent reads the related repositories and traces the impact in both directions. If a change would break a related repository, it reports a **cross-repository conflict** finding with a direct link to the affected lines in that repository.

The review runs automatically on any pull request in a repository that has at least one active relationship.

<Tip>
  By default, the review compares against the **main branch** of each related repository. If your change has a matching pull request or branch in the related repository, include the related pull request URL or branch name in your pull request description or a linked ticket so the conflict is evaluated against that code. Otherwise, Qodo may flag a conflict that a related, unmerged pull request already resolves. For more information, see [Cross-repository code review](/governance/cross-repo-code-review).
</Tip>

For how relationships are defined and how cross-repository review works in depth, see [Cross-repository code review](/governance/cross-repo-code-review).

## Configure cross-repository conflicts

### Configure cross-repository conflicts in the Qodo portal (Recommended)

1. Log in to the Qodo portal.
2. Set up a relationship between repositories. See [Manage cross-repository relationships](/governance/cross-repo-code-review/repository-relationships).
3. Navigate to **Configurations** > **Finding types**.
4. Verify that **Cross-repo impact** is enabled.

## View the cross-repository conflict in the findings

Cross-repository code review adds the following finding type to the review output:

🔗 **Cross-repo conflict**: A change in the pull request would break a related repository.

<Frame>
  <img src="https://mintcdn.com/qodo/VMUdmdhKSfW4uReb/images/governance/cross-repo-conflict-finding-in-pr.png?fit=max&auto=format&n=VMUdmdhKSfW4uReb&q=85&s=81c8004fa07df55b2b16eef7e80ca7f6" alt="Qodo pull request comment showing a cross-repository conflict finding with a description and a link to the affected code in the related repository" width="2094" height="1592" data-path="images/governance/cross-repo-conflict-finding-in-pr.png" />
</Frame>

Cross-repository conflicts appear alongside other review findings:

* 🐞 Bugs
* 📘 Rule violations
* 📎 Requirement gaps

All findings are displayed in a unified review comment. Cross-repository conflicts also appear on the [Findings page](/governance/view-all-findings-in-organization) in the Qodo portal, tagged `Cross-repo`.

## Cross-repository conflict details

Each cross-repository conflict finding includes:

* **Description**: Explanation of the breaking change and which related repository is affected
* **Code reference**: Link to the affected lines in the related repository
* **Evidence**: The related repository code used to detect the conflict, including a link to each relationship behind the finding
* **Agent prompt**: A suggested prompt to help resolve the issue

Relationship links are listed first in Evidence, one for each related repository involved in the conflict. Each link is labeled with the two repositories, such as `web-client -> api-server`.

Click a relationship link to open that relationship in the **Relationships** tab. The tab opens in Table view with the relationship's side panel open. From there, read the full relationship context, retry the analysis with custom instructions, download it as Markdown, or delete the relationship. For more information, see [View cross-repository relationships](/governance/repositories/relationships).

The same link appears in the finding's Evidence section on the [Findings page](/governance/view-all-findings-in-organization#finding-details) in the Qodo portal.

<Note>
  Access to the linked relationship follows your organization's portal permissions. If your organization restricts Software Map or Relationships access, or the relationship was deleted, the portal shows a message that the relationship could not be loaded. Contact your organization admin for access.
</Note>

## Related resources

* [Anatomy of a Qodo Code Review](/code-review/comment-anatomy): The parts of the review comment and how to read them.
* [Cross-repository code review](/governance/cross-repo-code-review): How relationships are defined and how cross-repository review works.
* [Manage cross-repository relationships](/governance/cross-repo-code-review/repository-relationships): Set up the relationships that cross-repository review uses.
* [Customize the code review experience](/configuration): What you can configure, and where to configure it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.