From 41d9edcec0830ce3daca661e66e586c3589ea6cf Mon Sep 17 00:00:00 2001 From: Shashank Jarmale Date: Mon, 8 Sep 2025 11:05:42 -0700 Subject: [PATCH] Clarify `Ownership Rules` documentation to clarify: we will not attempt to reassign a group that already has an assignee --- docs/product/issues/ownership-rules/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/product/issues/ownership-rules/index.mdx b/docs/product/issues/ownership-rules/index.mdx index cc581b6cbedba5..481fd8c2feab3b 100644 --- a/docs/product/issues/ownership-rules/index.mdx +++ b/docs/product/issues/ownership-rules/index.mdx @@ -8,7 +8,7 @@ description: "Learn how to set up ownership rules to automatically assign issues Sentry offers multiple ways to define the "ownership" of an issue. With ownership defined, we can automatically assign issues and send alerts to the owner. Sentry defines ownership with _code owners_ and _ownership rules_. Code owners functionality lets you import your [GitHub](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners) or [GitLab](https://docs.gitlab.com/ee/user/project/code_owners.html) CODEOWNERS file, and then we assign issues according to those file paths. Ownership rules allow you to override the assignments based on code owners and provide advanced matcher types (for example, urls and tags). These rules can also match on the file paths of files in the stack trace, URL of the request, or event tags. -If a user manually assigns an issue after it has been automatically assigned by Sentry, future auto-assignment will be turned off for that issue. +Once an issue has been assigned, whether manually by a user or automatically by Sentry, future auto-assignment will be turned off for that issue. ## Methods @@ -165,7 +165,7 @@ You can automatically assign issues to their owners by enabling the "Auto-assign ![Select from dropdown to automatically assign issues to their owners.](./img/auto-assign-issue-owner.png) -If an issue has been assigned manually in the past, new events will not change the current assignee. If an issue has not been assigned and a new event has multiple owners, Sentry assigns it to the owner(s) from the last matching rule (regardless of the rule `type`). +If an issue has been assigned in the past, manually or automatically, new events will not change the current assignee. If an issue has not been assigned and a new event has multiple owners, Sentry assigns it to the owner(s) from the last matching rule (regardless of the rule `type`). Please keep in mind that auto-assignment may be skipped if a project is creating too many new issues at a given time due to rate limits. We'll try to auto-assign it the next time an event comes in for those skipped issues. If you are encountering this limit with non-recurring issues, you may want to take a look at [issue grouping](/concepts/data-management/event-grouping/) strategies.