On this page

Search

Search works across all DevRev apps, offering seamless navigation and access to issues, tickets, articles, customers, and more. It also allows you to search through timeline comments related to these items. By using search queries and commands, you can refine your search and achieve more precise results.

Key actions in the search interface include:

  • Users can toggle between standard and expanded views for an enhanced search experience.

  • Clicking on a comment directs users to the specific comment within the relevant object panel.

  • Search results display details such as the comment author, timestamp, and comment text.

  • The interface shows up to two relevant comments per object.

To start a search, press Cmd + K on Mac or Ctrl + K on Windows, or click Search at the top of the left navigation bar.

search
A search query consists of the following syntax:

1 [operator]* [field]* [term/phrase]*

The above query specifies the following:

  • Filtering
  • Full-text search terms/phrases

Filtering is denoted by the query's [operator]* [field]*, which represents a logical AND of all operators (if specified). This is used to reduce the list of possible objects that can be returned in search results.

Full-text search terms/phrases are denoted by [term/phrase]* and are used to do full-text searches on object text fields.

Example: state: open, closed (field value)

Operators

Operators are used to filter the search results. The following table shows the syntax of each operator along with examples.

SyntaxDescriptionExamples
in:<body/title>Aids in searching within the body of the ticket/issue/enhancement or title.in:title crm
in:title "crm exp"
in:title crm exp
in:body "bot issues"
type:<object type>Enables users to filter by object type. Supported object types include: issue, enhancement, ticket, revu (for searching contacts), question_answer, conversation, article, devu (for searching dev contacts), account, feature, runnable.type:issue
type:enhancement in:title CRM
type:revu
type:enhancement, opportunity
type:issue, enhancement in:title crm
-Acts as an exclusion in search results. "-" can be used for the same purpose.type:issue -crm
type:issue in:title -crm
stateFilters results based on the stage: open, closed, or in_progress.state:open
state:closed
state:in_progress
severityFilters out tickets with the desired severity level. Supports: blocker, high, medium, low.severity:high
type:ticket -severity:low (filters all tickets excluding the ones with low severity)

Fields

Fields can be used along with operators to filter the search results further. The following table shows types of fields, syntax and it's examples.

Types of fieldSyntaxExamples
Boolean fields<field_name>:true (or :1)
<field_name>:false (or :0)
isCustomer:True
Submitted:0
Numeric fields<field_name>:<v>, <field_name>:<<v>, <field_name>:><v>
<field_name>:v1..v2
<field_name>:<=<v>
<field_name>:>=<v>
revenue:< 100
revenue:500..2000
discount>=0.25
tickets=< 5
String fields<field_name>:<v>Name: alice
Name:Alice,bob,eve
Date fields<field_name>:<v>
<field_name>:<=<v>
<field_name>:v1..v2
<field_name>:><v>
<field_name>:>=<v>
<field_name>:<<v>
target_release_date< 2020-10
target_release_date< 2020
Array fields<field_name>:<v> Here <v> is a CSV list of values where a match occurs if the array field contains an element having any of the values in the list.tags:performance (string array)
magic_dates_c:1970-01-01,2006-01-02 (date array)
Modified_date:2024-01-02..2024-01-05 (fetches records that were modified lies within 2024-01-02 and 2024-01-05)
created_date:2023 (fetches records that were created in 2023)

Integrating search with customization

DevRev's customization framework allows you to extend core objects with custom fields and create custom object types. These customizations are fully searchable using the same search syntax as standard fields.

Search over custom fields

Custom fields use the standard field search syntax and support all field types including text, numeric, boolean, date, and array fields. Custom fields that are specific to a subtype require the subtype filter to be included in your search query.

Syntax:

1 subtype:<subtype_name> <custom_field_name>:<value>

** For examples:**

Search for tickets related to access issues with tenant field escalated:

tnt__escalated access issues

Search for bugs related to access issues with subtype field customer_impact:

subtype ctype__customer_impact access issues

Search across multiple subtypes for tickets related to access issues:

subtype,Events access issues

Limitations:

  • Subtype specific field filters are not supported while searching across multiple subtypes.

Learn more about creating and managing custom fields in the Object customization guide.

Search over custom objects

Custom fields use the standard field search syntax and support all field types including text, numeric, boolean, date, and array fields. You should add the leaf_type filter while searching over custom objects.

Search for book custom objects related to AI agents:

subtype AI agents

Search for book custom objects related to AI agents with tenant field author:

subtype author:"Chip Huyen" AI agents

For detailed information on creating custom objects, see the Custom objects guide.