---
title: "Issue Properties"
description: "Learn more about searchable issue properties."
url: https://docs.sentry.io/concepts/search/searchable-properties/issues/
---

# Issue Properties

[Issues](https://docs.sentry.io/product/issues.md) are an aggregate of one or more error events. Searchable issues properties include status, assignment, aggregate counts, and age. If you have set up [evaluation tracking for feature flags](https://docs.sentry.io/product/issues/issue-details/feature-flags.md#evaluation-tracking), you can search for issues that have error events where the feature flag evaluated value is `true` or `false`. You can search by issue properties in the **Issues** page and in **Dashboards** in the widget builder, depending on your dataset selection.

## [Searchable Properties](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#searchable-properties)

Below is a list of keys and tokens that can be used in the issues search.

You'll only need to use query syntax for **datetime** and **relative time** searchable property types if you're using the Sentry [API](https://docs.sentry.io/api.md).

### [`age`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#age)

Returns issues created since the time defined by the value. The syntax is similar to the Unix find command. Supported suffixes: `m - minutes`, `h - hours`, `d - days`, `w - weeks`. For example, `age:-24h` returns issues that are new in the last 24 hours, while `age:+12h` returns ones that are older than 12 hours. Entering `age:+12h age:-24h` would return issues created between 12 and 24 hours ago.

* **Type:** relative time

### [`app.in_foreground`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#appin_foreground)

Indicates if the app is in the foreground or background. Values are `1/0` or `true/false`

* **Type:** boolean

### [`assigned`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#assigned)

Returns issues assigned to the defined user(s) or team(s). Values can be a user ID (your email address), `me` for yourself, `none` for no assignee, `my_teams` or `#team-name` for teams you belong to.

* **Type:** team or org user

### [`assigned_or_suggested`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#assigned_or_suggested)

Returns issues that are either assigned to the defined user(s) or team(s), or suggested to be assigned to the defined user(s) or team(s) and are currently unassigned. Suggested assignees are found by matching [ownership rules](https://docs.sentry.io/product/issues/ownership-rules.md) and [suspect commits](https://docs.sentry.io/product/issues/suspect-commits.md). Values can be a user ID (your email address), `me` for yourself, `none` for no assignee/suggestion, `my_teams` or `#team-name` for teams you belong to.

* **Type:** team or org user

### [`bookmarks`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#bookmarks)

Returns issues bookmarked by the defined user. Values can be your user ID (your email address) or `me` for yourself.

* **Type:** team or org user

### [`device.arch`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicearch)

CPU architecture

* **Type:** string

### [`device.brand`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicebrand)

Brand of the device

* **Type:** string

### [`device.family`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicefamily)

Family of the device. Typically, the common part of a model name across generations. For example, iPhone, Samsung Galaxy.

* **Type:** string

### [`device.locale`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicelocale)

Deprecated

* **Type:** string

### [`device.model_id`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicemodel_id)

Internal hardware revision to identify the device exactly.

* **Type:** n/a

### [`device.orientation`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#deviceorientation)

Describes the orientation of the device and can be either `portrait` or `landscape`.

* **Type:** string

### [`device.screen_density`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicescreen_density)

Device screen density in pixels.

* **Type:** string

### [`device.screen_dpi`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicescreen_dpi)

Number of dots per inch of the device screen.

* **Type:** string

### [`device.screen_height_pixels`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicescreen_height_pixels)

Device screen height in pixels.

* **Type:** string

### [`device.screen_width_pixels`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#devicescreen_width_pixels)

Device screen width in pixels.

* **Type:** string

### [`device.uuid`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#deviceuuid)

Deprecated

* **Type:** UUID

### [`dist`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#dist)

Distinguishes build or deployment variants of the same release of an application. For example, the dist can be the build number of an Xcode build or the version code of an Android build.

* **Type:** string

### [`error.handled`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#errorhandled)

Indicates whether the user has handled the exception — for example, using try...catch. An error is considered handled if all stack traces handle the error. Values are `1/0` or `true/false`

* **Type:** boolean

### [`error.main_thread`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#errormain_thread)

Indicates if the error occurred on the main thread. Values are `1/0` or `true/false`

* **Type:** boolean

### [`error.mechanism`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#errormechanism)

An object describing the mechanism that created this exception.

* **Type:** array

### [`error.type`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#errortype)

The type of exception. For example, `ValueError`.

* **Type:** array

### [`error.unhandled`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#errorunhandled)

The inversion of `error.handled`.

* **Type:** boolean

### [`error.value`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#errorvalue)

Original value of a field that causes or exhibits the error.

* **Type:** array

### [`event.timestamp`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#eventtimestamp)

Returns issues with matching datetime.

* **Type:** datetime

### [`event.type`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#eventtype)

Type of the event (transaction, error, default, csp, and so on). The transaction type is unavailable in **Issues**.

* **Type:** string

### [`firstRelease`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#firstrelease)

Returns issues first seen within the given release. Can be an exact match on the version of a release, or `first-release:latest` to pick the most recent release.

* **Type:** datetime

### [`firstSeen`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#firstseen)

Returns issues with a matching first time seen. Syntax is the same as `age`.

* **Type:** datetime

### [`flags`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#flags)

For [feature flag evaluations](https://docs.sentry.io/product/issues/issue-details/feature-flags.md#evaluation-tracking) set to `true` or `false`, the name of the feature flag. For example, the syntax for searching for a flag with key `my_flag` and value `true` is `flags["my_flag"]:true`.

* **Type:** boolean

### [`geo.city`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#geocity)

Full name of the city

* **Type:** string

### [`geo.country_code`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#geocountry_code)

ISO 3166-1 country code

* **Type:** string

### [`geo.region`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#georegion)

Full name of the country

* **Type:** string

### [`has`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#has)

Returns results with the defined tag or field, but not the value of that tag or field. For example, entering `has:user` would find events with the `user` tag.

* **Type:** error

### [`http.method`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#httpmethod)

HTTP method of the [request](https://develop.sentry.dev/sdk/foundations/transport/event-payloads/request/) that created the event.

* **Type:** string

### [`http.referer`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#httpreferer)

Identifies the web page from which the resource was requested.

* **Type:** string

### [`http.status_code`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#httpstatus_code)

HTTP status code, which indicates whether a response was successful. For example, `200` or `404`.

* **Type:** string

### [`http.url`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#httpurl)

Full URL of the request that caused the error, but without any parameters

* **Type:** string

### [`id`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#id)

The event or replay id. In **Issues**, use only the ID value without the `id` key.

* **Type:** UUID

### [`is`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#is)

The properties of an issue. Values can be: `unresolved`, `resolved`, `archived`, `assigned`, `unassigned`, `for_review`, `linked`, or `unlinked`. The `for_review` value filters unresolved issues and only shows the recently unresolved or new issues that haven't been marked as "reviewed". The `linked` and `unlinked` values return issues based on whether they're linked to an external issue tracker or not.

* **Type:** status

### [`issue`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#issue)

The short issue code, for example `SENTRY-ABC`.

* **Type:** string

### [`issue.category`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#issuecategory)

The category of the issue. For example: `error`, `performance`, `replay` and `cron`.

* **Type:** string

### [`issue.type`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#issuetype)

The specific type of issue. For example `issue.type:performance_n_plus_one_db_queries `returns the n plus one db query performance issues.

* **Type:** string

### [`lastSeen`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#lastseen)

Datetime when the event was last seen. For example, `lastSeen:+30d` returns issues last seen 30 days ago or more; `lastSeen:-2d` returns issues last seen within the past two days. This is similar to `age`.

* **Type:** datetime

### [`level`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#level)

Severity of the event (such as: fatal, error, warning). Always set to info for transactions.

* **Type:** string

### [`location`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#location)

Location where the error happened.

* **Type:** string

### [`message`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#message)

Returns errors with the matching message or transactions with matching transaction name. Also matches on any message containing the supplied value.Searching `message:undefined` will match an event with a message of `undefined is not an object`. Raw text searches (searches without the `message` key) are also checked against this field. For errors, the message can be a concatenatenation of elements, so searches might include unexpected results.

* **Type:** string

### [`os.build`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#osbuild)

The internal build revision of the operating system.

* **Type:** string

### [`os.kernel_version`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#oskernel_version)

The independent kernel version string. This is typically the entire output of the `uname` syscall.

* **Type:** string

### [`os.distribution_name`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#osdistribution_name)

The Linux distribution name. This maps to `ID` in [`/etc/os-release/`](https://www.freedesktop.org/software/systemd/man/latest/os-release.html).

* **Type:** string

### [`os.distribution_version`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#osdistribution_version)

The Linux distribution version. This maps to `VERSION_ID` in [`/etc/os-release/`](https://www.freedesktop.org/software/systemd/man/latest/os-release.html).

* **Type:** string

### [`platform.name`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#platformname)

Name of the platform

* **Type:** string

### [`project`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#project)

The name of the project. In some pages of [sentry.io](https://sentry.io), you can also filter on project using a dropdown.

* **Type:** string

### [`project.id`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#projectid)

The id of the project.

* **Type:** number

### [`release`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#release)

A release is a version of your code deployed to an environment. You can create a token with an exact match of the version of a release, or `release:latest` to pick the most recent release. [Learn more](https://docs.sentry.io/product/releases/usage/sorting-filtering.md#latest-release).

* **Type:** string

### [`release.build`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#releasebuild)

The number that identifies an iteration of your app. For example, `CFBundleVersion` on iOS or `versionCode` on Android. [Learn more](https://docs.sentry.io/product/releases/usage/sorting-filtering.md).

* **Type:** number

### [`release.package`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#releasepackage)

The unique identifier of the project/app. For example, `CFBundleIdentifier` on iOS or `packageName` on Android. [Learn more](https://docs.sentry.io/product/releases/usage/sorting-filtering.md).

* **Type:** string

### [`release.stage`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#releasestage)

The usage your release is seeing relative to other releases. Values can be `adopted`, `low`, or `replaced`. [Learn more](https://docs.sentry.io/product/releases/health.md#adoption-stages).

* **Type:** string

### [`release.version`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#releaseversion)

A shorter version of the name; name without the package or short version of the hash. [Learn more](https://docs.sentry.io/product/releases/usage/sorting-filtering.md).

* **Type:** string

### [`sdk.name`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#sdkname)

Name of the Sentry SDK that sent the event.

* **Type:** string

### [`sdk.version`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#sdkversion)

Version of the Sentry SDK that sent the event.

* **Type:** string

### [`stack.abs_path`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#stackabs_path)

The absolute path to the source file. In events, this is an array; in issues, this is a single value.

* **Type:** array, single value

### [`stack.filename`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#stackfilename)

The path to the source file relative to the project root directory. In events, this is an array. In issues, this is a single value.

* **Type:** array, single value

### [`stack.function`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#stackfunction)

Name of the function being called. In events, this is an array. In issues, this is a single value.

* **Type:** array, single value

### [`stack.module`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#stackmodule)

Platform-specific module path. For example, `sentry.interfaces.Stacktrace`. In events, this is an array. In issues, this is a single value.

* **Type:** array, single value

### [`stack.package`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#stackpackage)

The "package" the frame was contained in. Depending on the platform, this can be different things. For C#, it can be the name of the assembly. For native code, it can be the path of the dynamic library or something else. In events, this is an array. In issues, this is a single value.

* **Type:** array, single value

### [`timesSeen`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#timesseen)

Returns results with a matching count. (Same as `count()` in events.)

* **Type:** number

### [`timestamp`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#timestamp)

The finish timestamp of the transaction. Returns events with matching datetime.

* **Type:** datetime

### [`title`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#title)

Title of the error or the transaction name.

* **Type:** string

### [`trace`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#trace)

A trace represents the record of the entire operation you want to measure or track — like page load, searched using the UUID generated by Sentry’s SDK.

* **Type:** UUID

### [`transaction`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#transaction)

For [transactions](https://docs.sentry.io/product/insights/overview/transaction-summary.md#what-is-a-transaction), the name of the transaction. For errors, the name of the associated transaction.

* **Type:** string

### [`unreal.crash_type`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#unrealcrash_type)

The [Unreal Crash Context Type](https://docs.unrealengine.com/4.27/en-US/API/Runtime/Core/GenericPlatform/ECrashContextType/)

* **Type:** string

### [`user.email`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#useremail)

An alternative, or addition, to the username. Sentry is aware of email addresses and can therefore display things such as Gravatars and unlock messaging capabilities.

* **Type:** string

### [`user.id`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#userid)

Application-specific internal identifier for the user.

* **Type:** string

### [`user.ip`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#userip)

User's IP address. Sentry uses the IP address as a unique identifier for unauthenticated users.

* **Type:** string

### [`user.username`](https://docs.sentry.io/concepts/search/searchable-properties/issues.md#userusername)

Username, which is typically a better label than the `user.id`.

* **Type:** string
