Skip to content

feat(search-syntax): Add new wildcard ops #15098

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open

feat(search-syntax): Add new wildcard ops #15098

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
0a3968e
:art: Apply prettier
nsdeschenes Sep 11, 2025
400e1cf
:speech_balloon: Change asterisk wildcard from opreator to character
nsdeschenes Sep 11, 2025
adc040a
:sparkles: Add in new section regarding wildcard operators
nsdeschenes Sep 11, 2025
1378334
:speech_balloon: Update Wildcards to Wildcard Character
nsdeschenes Sep 15, 2025
bbd0496
:speech_balloon: Update to new spaceless wildcard operators
nsdeschenes Sep 15, 2025
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
33 changes: 29 additions & 4 deletions docs/concepts/search/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,10 @@ Search is available on several features throughout [sentry.io](https://sentry.io
## Query Syntax

<Alert>
You'll only need to use query syntax if you're using a Sentry [API](/api/). You'll get pre-populated suggestions once you start typing in your search terms when using the search bar anywhere in [Sentry.io](https://sentry.sentry.io/).
You'll only need to use query syntax if you're using a Sentry [API](/api/).
You'll get pre-populated suggestions once you start typing in your search
terms when using the search bar anywhere in
[Sentry.io](https://sentry.sentry.io/).
</Alert>

Search queries are constructed using a `key:value` pattern, with an optional raw search at the end. Each `key:value` pair is a `token` and the optional raw search is itself a single `token`. The `key:value` pair `tokens` are treated as issue or event properties. The optional raw search is treated as a single `token` and searches event titles/messages.
Expand Down Expand Up @@ -112,24 +115,46 @@ is:unresolved !user.email:example@customer.com

In the example above, the search query returns all Issues that are unresolved _and_ have not affected the user with the email address `example@customer.com`.

#### Wildcards
#### Wildcard Character

Search supports the wildcard operator `*` as a placeholder for specific characters and strings.
Search supports the wildcard character `*` as a placeholder for specific characters and strings.

```
browser:"Safari 11*"
```

In the example above, the search query will match on `browser` values like `"Safari 11.0.2"`, `"Safari 11.0.3"`, etc.

You may also combine operators like so:
You may also combine the wildcard character `*` with other operators like so:

```
!message:"*Timeout"
```

In the above example, the search query returns results which do not have message values like `ConnectionTimeout`, `ReadTimeout`, etc.

#### Wildcard Operators

<Alert>
When using these operators, the base wildcard character `*` will be treated as
a literal character and not as a wildcard.
</Alert>

Sentry's API supports the use of the following wildcard operators when making requests to the API.

For ease of use, we recommend using the wildcard `*` character instead of these operators when manually querying the API.

```
# contains, and does not contain
browser:Containschrome, !browser:Containsfire
Copy link
Contributor

Choose a reason for hiding this comment

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

@nsdeschenes Are these supposed to show as rectangles like this?
Screenshot 2025-10-06 at 1 54 30 PM

Copy link
Author

Choose a reason for hiding this comment

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

Yessir, the squares are actually unicode characters that we use to delineate that these are wildcard operators, and not part of the users query.

In an ideal world, users will not be using these directly, rather interacting with the UI, which handles all of this for them, and they never see it.


# starts with, and does not start with
browser:StartsWithchrome, !browser:StartsWithchrome

# ends with, and does not end with
browser:EndsWithchrome, !browser:EndsWithfire
```

## Page Filters

Page filters allow you to narrow down the results shown on a page by selecting specific projects, environments, and date ranges. After you've set your filters, they'll persist as you navigate across pages in Sentry.
Expand Down
Loading