Custom search queries

In Sessions, enter a custom search query into the search bar. You can also save your custom queries and use them later.

Build a query

Enter one or more space-separated parameters to build a query. When a query is run, each parameter is joined by an AND condition, and the results are returned in the session list.

The custom queries parameters

Example
status:passed type:manual os:android # Returns all passing, manual sessions, using a device with an Android OS.

To use the OR operation, include the parameters in brackets.

Example
(is:applitools OR is:sensitive) # Return Applitools Eyes session or session with sensitive data

To combine AND and OR operation, make sure OR parameters are inside brackets and AND operation are not inside brackets (and without the AND between parameters).

Example
(type:manual OR is:applitools) user:"johndoe" # Find manual sessions or Applitools Eyes sessions that were created by user johndoe

Save a query

After a query is built, select Add Saved Search, then Save. Now you can run this query any time you search for a session.

Click Star to add Saved Search

Parameters

application:

Returns all sessions using this application. application: takes a space-separated string surrounded in double quotes "" or a concatenated string with or without double quotes "".

Example
application:"wingman api" # Returns all sessions using the Wingman API app.
application:guardian # Returns all sessions using the Gaurdian app.

is:

Returns all sessions that belong to a special category. For manual or automation sessions, see type:.

Example
is:scriptless # Scriptless sessions.
is:applitools # Applitools eyes sessions.
is:sensitive # Sessions with sensitive data.

manufacturer:

Returns all sessions using devices with this manufacturer.

Example
manufacturer:apple # Returns all sessions using an Apple device.

model:

Returns all sessions using this device model. model: takes a space-separated string surrounded in double quotes "" or a concatenated string with or without double quotes "".

Example
model:"redmi note 7" # Returns all sessions using a Xiaomi Redmi Note 7.
model:mq9d2 # Returns all sessions using a Space Gray iPhone 8 Plus.

os:

Returns all sessions using a device with this operating system (OS).

Example
os:ios # Returns all sessions using an iOS device.

os_version:

Returns all sessions using a device with this operating system version (OS version).

Example
os_version:14.7.1 # Returns all sessions using an iOS device on version 14.7.1.

resolution:

Returns all sessions using devices with this screen resolution.

Example
resolution:720x1080 # Returns all sessions using a device with a 720x1080 screen resolution.

status:

Returns all sessions matching this status. For more information, see Session tags.

Example
status:running # Returns all sessions currently running.

type:

Returns all sessions with this session type: manual or appium. For scriptless sessions, see is:.

Example
type:manual
type:appium
type:xcuitest
type:espresso
type:gaming
type:mixed

udid:

Returns all sessions using a device with this UDID.

Example
udid:6ec7ca0e # Returns all sessions using a device with UDID 6ec7ca0e.

user:

Returns all sessions started by this user. You may only search users assigned to your team.

Example
user:alex # Returns all sessions started by Alex.