Zendesk Support search reference

<body>
<p id="docs-hc-snippet" style="display: none;">This article contains tables listing and describing data property keywords and values that can be used, along with common search operators, to narrow your search results. There are also sections describing more advanced search methods and formatting.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_all">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_all">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Team, Professional, or Enterprise</td>
</tr>
</tbody>
</table>
</div>

</div>

<div class="body">

<p class="p">This article contains tables listing and describing data property keywords and
values that can be used, along with common search operators, to narrow your
search results. There are also sections describing more advanced search
methods and formatting. </p>
<p class="p">This article is for admins with full access to the data in Zendesk Support. If
you're an agent, start with <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408894221594" target="_blank">Searching Zendesk data</a> and
refer back to this reference article if you want to perform more advanced
searches.</p>
<p class="p">This article includes the following topics on search:</p>
<div class="p">
<ul class="ul">
<li class="li"><a class="xref" href="#topic_mq4_5qj_nlb">About search and search terminology</a></li>
<li class="li"><a class="xref" href="#topic_fhr_wsc_3v">Searching for
properties that contain no data</a></li>
<li class="li"><a class="xref" href="#topic_ghr_wsc_3v">Searching by date
and time</a></li>
<li class="li"><a class="xref" href="#topic_lhr_wsc_3v">Sorting search
results</a></li>
<li class="li"><a class="xref" href="#topic_ohr_wsc_3v">Using the 'type'
keyword</a></li>
</ul>
</div>
<p class="p">This article includes the following reference tables:</p>
<ul class="ul" id="topic-1__ul_cmy_pnw_rm">
<li class="li"><a class="xref" href="#topic_ngr_frb_vc">Search
operators</a></li>
<li class="li"><a class="xref" href="#topic_crj_yev_uc">Ticket property
keywords</a></li>
<li class="li"><a class="xref" href="#topic_rvz_afv_uc">User property
keywords</a></li>
<li class="li"><a class="xref" href="#topic_gok_ffv_uc">Organization property
keywords</a></li>
<li class="li"><a class="xref" href="#topic_wcx_ifv_uc">Group property
keywords</a></li>
<li class="li"><a class="xref" href="#topic_nms_sgd_jf">Satisfaction rating
searchable values</a></li>
</ul>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_mq4_5qj_nlb">
<h2 class="title topictitle2" id="ariaid-title2">About search and search terminology</h2>
<div class="body">
<p class="p">You can narrow your search results by using <em class="ph i">data property
keywords</em>, <em class="ph i">operators</em>, and <em class="ph i">search terms</em>:</p>
<div class="p">
<ul class="ul" id="topic_mq4_5qj_nlb__ul_j1z_dmf_x5">
<li class="li">
<strong class="ph b">Search terms</strong> are the words, phrases, or values
you are searching for. See <a class="xref" href="#topic_jfw_rsj_nlb">About
search terms</a>.</li>
<li class="li">
<strong class="ph b">Data property keywords</strong> indicate that you are
restricting a search to one or more specific data
properties. See <a class="xref" href="#topic_brt_1sj_nlb">About property keywords</a>.</li>
<li class="li">
<strong class="ph b">Operators</strong> are symbols used to modify the keywords
and focus the search. See <a class="xref" href="#topic_ngr_frb_vc">Search
operators</a>.</li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested2" id="topic_jfw_rsj_nlb">
<h3 class="title topictitle3" id="ariaid-title3">About search terms</h3>
<div class="body">
<p class="p">Search terms are user-defined words, phrases, or values.
Examples:</p>
<div class="p">
<ul class="ul" id="topic_jfw_rsj_nlb__ul_ck1_snw_nlb">
<li class="li">3245227</li>
<li class="li">Greenbriar</li>
<li class="li">serial number</li>
<li class="li">"Jane Doe"</li>
</ul>
</div>
<p class="p">Search terms can include any string, including user,
organization, or group names. For example, you can search
for "vip" to list all users tagged as VIPs. However, the
results also include other data that match the term "vip."
For instance, if an organization has "vip" in its name, such
as "Midwest VIP Transportation" or "Viper Reptile
Supplies,", it appears in your search results even if it
doesn't have the VIP tag.</p>
<p class="p">Search terms are case-insensitive. For example, "App" and "app"
return the same results.</p>
<p class="p">A single-word search term returns a result if it appears in the
data as follows:</p>
<ul class="ul" id="topic_jfw_rsj_nlb__ul_tg4_wqj_nlb">
<li class="li">a single word</li>
<li class="li">a single word in a longer phrase</li>
<li class="li">the prefix of a longer word</li>
</ul>
<p class="p">The search term will not return a result if it appears in the
data as follows:</p>
<ul class="ul" id="topic_jfw_rsj_nlb__ul_ug4_wqj_nlb">
<li class="li">in the middle of a word</li>
<li class="li">at the end of a word</li>
</ul>
<p class="p">For example, the search term "top" would match "top", "top tier",
"Top Ten Trucking", "Tip-Top Mops", "Big Top Entertainment",
and "Dessert Toppings, Inc". It would not match "Desktop
Solutions" or "One-Stop Publishing".</p>
<div class="p">Search terms can consist of multiple words. There is a 64 word
limit in a search query. If submitting multiple search
terms, search has a default AND behavior, rather than an OR
behavior. For example, searching for the following phrase
returns results only if <em class="ph i">all</em> of the words are present,
in any order.<pre class="pre">Please upgrade my account</pre>
</div>
<p class="p">Enclose the words in double quotes if you want the search to only
return exact matches. For example: "Jane Doe." You can omit
the quotes, in which case search reverts to AND matching
logic. In other words, all the words must be present in the
record in any order for a match.</p>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested2" id="topic_brt_1sj_nlb">
<h3 class="title topictitle3" id="ariaid-title4">About property keywords</h3>
<div class="body">
<p class="p">You can narrow your results by combining <em class="ph i">property keywords</em>
with search terms and <a class="xref" href="#topic_ngr_frb_vc">operators</a>. For example:</p>
<div class="p">
<pre class="pre codeblock"><code>status&lt;solved</code></pre>
</div>
<p class="p">A property keyword is the name of a property in a ticket, a user,
an organization, or a group. Examples:</p>
<ul class="ul" id="topic_brt_1sj_nlb__ul_w2p_gsw_nlb">
<li class="li">assignee</li>
<li class="li">created</li>
<li class="li">name</li>
</ul>
<p class="p">See the following property keyword references for all the
properties and details about each:</p>
<div class="p">
<ul class="ul">
<li class="li"><a class="xref" href="#topic_crj_yev_uc">Ticket property keywords</a></li>
<li class="li"><a class="xref" href="#topic_rvz_afv_uc">User property keywords</a></li>
<li class="li"><a class="xref" href="#topic_gok_ffv_uc">Organization property keywords</a></li>
<li class="li"><a class="xref" href="#topic_wcx_ifv_uc">Group property keywords</a></li>
</ul>
</div>
<p class="p">Example property searches:</p>
<div class="p">
<table border="1" cellpadding="4" cellspacing="0" class="simpletable" id="topic_brt_1sj_nlb__simpletable_mmb_frp_nlb" summary="">
<col style="width:25.222222222222225%">
<col style="width:20.555555555555557%">
<col style="width:54.222222222222214%">
<thead>
<tr class="sthead">
<th class="stentry" id="d51e317" style="vertical-align:bottom;text-align:left;">Search</th>
<th class="stentry" id="d51e320" style="vertical-align:bottom;text-align:left;">Property keyword</th>
<th class="stentry" id="d51e323" style="vertical-align:bottom;text-align:left;">Returns</th>
</tr>
</thead>
<tbody>
<tr class="strow">
<td class="stentry" headers="d51e317" style="vertical-align:top;">priority&gt;normal </td>
<td class="stentry" headers="d51e320" style="vertical-align:top;">priority</td>
<td class="stentry" headers="d51e323" style="vertical-align:top;">Tickets with a priority of high or
urgent</td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e317" style="vertical-align:top;">subject:2fa</td>
<td class="stentry" headers="d51e320" style="vertical-align:top;">subject</td>
<td class="stentry" headers="d51e323" style="vertical-align:top;">Tickets with the search term 2fa in the
subject</td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e317" style="vertical-align:top;">email:jdoe@example.com</td>
<td class="stentry" headers="d51e320" style="vertical-align:top;">email</td>
<td class="stentry" headers="d51e323" style="vertical-align:top;">The user with the email
jdoe@example.com</td>
</tr>
</tbody>
</table>
</div>
<p class="p">Some properties have predefined values. For example, the ticket
status property has the following predefined values: new,
open, pending, hold, solved, closed. You can only search by
these values. Example search: <code class="ph codeph">status:open</code>.
See the property keyword references for details about each
property.</p>
<p class="p">Other properties accept user-defined search terms. Example:
<code class="ph codeph">subject:2fa</code>. See <a class="xref" href="#topic_jfw_rsj_nlb">About search terms</a>. The same
matching rules apply for property searches with the
exception of prefix matching. Results are not returned if
the search term appears as the prefix of a longer word. For
example, the search term "tier" would return results for
"tier 1" and "tier 2" but not "tiered".</p>
<p class="p">You can search for multiple values of a single property by
including the property keyword multiple times in a query.
Example:</p>
<div class="p">
<pre class="pre">tags:silver tags:bronze</pre>
</div>
<p class="p">Search uses OR logic for matching in this case. The previous
example returns results that contain either the tag "silver"
or the tag "bronze."</p>
<div class="p">You can combine these keyword search statements to narrow your
results even further. For
example:<pre class="pre">status:open group:"Level 2"</pre>
</div>
<p class="p">This returns all the open tickets that are assigned to the Level
2 support group. </p>
</div>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested2" id="topic_y1p_xqj_nlb">
<h3 class="title topictitle3" id="ariaid-title5">Example search</h3>
<div class="body">
<p class="p">The following search expression looks for anything with the tag
"vip" that was created before May 1, 2019:</p>
<div class="p">
<pre class="pre codeblock"><code>tags:vip created&lt;2019-05-01</code></pre>
</div>
<div class="p">How it works:<ul class="ul" id="topic_y1p_xqj_nlb__ul_jtb_zqj_nlb">
<li class="li">
<strong class="ph b">tags</strong> is a property keyword indicating
you're searching only within a specific data
property, in this case a <em class="ph i">tag</em>.</li>
<li class="li">
<strong class="ph b">:</strong> is the "equal to" operator indicating
the <em class="ph i">tag</em> property value needs to be equal to
the subsequent search term. Note that there's no
space before or after the <strong class="ph b">:</strong>.</li>
<li class="li">
<strong class="ph b">vip</strong> is the search term.</li>
<li class="li">
<strong class="ph b">created</strong> is a property keyword indicating
you're searching the <em class="ph i">created</em> data property
for items created relative to a certain date.</li>
<li class="li">
<strong class="ph b">&lt;</strong> is the "less than" operator
indicating you're searching for records created
before a certain date.</li>
<li class="li">
<strong class="ph b">2015-05-01</strong> is a search term indicating
the date you want to use.</li>
</ul>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title6" class="topic nested1" id="topic_ghr_wsc_3v">
<h2 class="title topictitle2" id="ariaid-title6">Searching by date and time</h2>
<div class="body">
<p class="p">The date property keywords <em class="ph i">created</em>, <em class="ph i">updated</em>, <em class="ph i">solved</em>,
and <em class="ph i">due date</em> can be combined with search operators to return
data from a specific date, before a certain date, and after a
certain date. To search dates in any locale, use the format
YYYY-MM-DD. You can also use locale-specific formats such as
MM/DD/YYYY in the United States.</p>
<div class="p">To search for data before a certain date, use the less than (<strong class="ph b">&lt;</strong>)
operator:<pre class="pre">created&lt;2011-05-01</pre>
</div>
<div class="p">To search for data after a certain date, use the greater than (&gt;)
operator:<pre class="pre">due_date&gt;2010-01-10</pre>
</div>
<div class="p">To search for a specific date, use the equals (<strong class="ph b">:</strong>)
operator:<pre class="pre">solved:2010-01-10</pre>
</div>
<p class="p">You can also use the <em class="ph i">&lt;=</em> or <em class="ph i">&gt;=</em> operators to indicate
<em class="ph i">less-than-or-equal-to</em> and
<em class="ph i">greater-than-or-equal-to</em> respectively.</p>
</div>
<div aria-labelledby="ariaid-title7" class="topic nested2" id="topic_hhr_wsc_3v">
<h3 class="title topictitle3" id="ariaid-title7">Searching with combined dates and times</h3>
<div class="body">
<div class="p">You can specify a combined date and time using <a class="xref" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO8601 syntax</a>:
<pre class="pre">created&gt;2015-09-01T12:00:00-08:00
updated&lt;2015-09-01T12:00:00Z</pre>
</div>
<p class="p">The first example above searches for anything created after
September 1, 2015 at 12:00 p.m. (Pacific Standard Time).</p>
<p class="p">The second example above searches for anything updated before
September 1, 2015 at 12:00 p.m. (UTC). </p>
</div>
</div>
<div aria-labelledby="ariaid-title8" class="topic nested2" id="topic_ihr_wsc_3v">
<h3 class="title topictitle3" id="ariaid-title8">Searching within a date/time range</h3>
<div class="body">
<div class="p">You can search within a date range, for example August 2, 2014
through August 4, 2014, using the following search
statement:
<pre class="pre">created&gt;2014-08-01 created&lt;2014-08-05</pre>
</div>
<p class="p">You can also include specific times in your search range. The
following example searches for anything created between
August 1, 2014 at 11:59 p.m. (UTC) and August 4, 2014 at
midnight (UTC):</p>
<div class="p">
<pre class="pre">created&gt;2014-08-01T23:59:00Z created&lt;2014-08-04T23:59:59Z</pre>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title9" class="topic nested2" id="topic_jhr_wsc_3v">
<h3 class="title topictitle3" id="ariaid-title9">Searching with relative times</h3>
<div class="body">
<p class="p">You can search for a time relative to the present time, using the
time units <em class="ph i">hours</em>, <em class="ph i">minutes</em>, <em class="ph i">days</em>,
<em class="ph i">weeks</em>, <em class="ph i">months</em>, or <em class="ph i">years</em>. The
following search returns anything created in the last four
hours:</p>
<div class="p">
<pre class="pre">created&gt;4hours</pre>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title10" class="topic nested1" id="topic_lhr_wsc_3v">
<h2 class="title topictitle2" id="ariaid-title10">Sorting search results</h2>
<div class="body">
<div class="p">You can sort your search results by field, in ascending or descending
order, using the following keyword phrases:<ul class="ul" id="topic_lhr_wsc_3v__ul_mhr_wsc_3v">
<li class="li"><code class="ph codeph">order_by:<em class="ph i">field</em></code></li>
<li class="li">
<code class="ph codeph">sort:asc</code> or
<code class="ph codeph">sort:desc</code>
</li>
</ul>
</div>
<div class="p">Sorting is available on the following fields:<ul class="ul" id="topic_lhr_wsc_3v__ul_nhr_wsc_3v">
<li class="li"><code class="ph codeph">created</code></li>
<li class="li"><code class="ph codeph">commented</code></li>
<li class="li"><code class="ph codeph">priority</code></li>
<li class="li"><code class="ph codeph">status</code></li>
<li class="li"><code class="ph codeph">ticket_type</code></li>
</ul>
</div>
<p class="p">Using the <code class="ph codeph">order_by</code> and <code class="ph codeph">sort</code> keywords is
equivalent to using the API parameters <code class="ph codeph">sort_by</code> and
<code class="ph codeph">sort_order</code>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title11" class="topic nested1" id="topic_fhr_wsc_3v">
<h2 class="title topictitle2" id="ariaid-title11">Searching for properties that contain no data</h2>
<div class="body">
<div class="p">You can search properties that contain no data using
<code class="ph codeph">none</code> as the search term, along with the
<em class="ph i">group</em>, <em class="ph i">tags</em>, <em class="ph i">via</em>, <em class="ph i">organization</em>,
or <em class="ph i">assignee</em> keywords. For
example:<pre class="pre">assignee:none</pre>
</div>
<p class="p">This returns all unassigned tickets.</p>
</div>
</div>
<div aria-labelledby="ariaid-title12" class="topic nested1" id="topic_ohr_wsc_3v">
<h2 class="title topictitle2" id="ariaid-title12">Using the 'type' keyword</h2>
<div class="body">
<p class="p">You can use the <code class="ph codeph"><em class="ph i">type</em></code> keyword to narrow your
search results. It is used to explicitly declare that you want to
search for one of the following types: </p>
<div class="p">
<ul class="ul" id="topic_ohr_wsc_3v__ul_phr_wsc_3v">
<li class="li">ticket</li>
<li class="li">user </li>
<li class="li">organization </li>
<li class="li">group</li>
</ul>
</div>
<p class="p">Using the <code class="ph codeph">type</code> keyword means that you are explicitly
searching on the type you specify. For example, you can search for
all the users that belong to the customer's organization using this
search statement: </p>
<div class="p">
<pre class="pre codeblock"><code>type:user organization:customers</code></pre>
</div>
<p class="p">If you instead searched for <code class="ph codeph">organization:customers</code> you
would also get all the tickets that have requesters who belong to
this organization. This is because searches that do not explicitly
specify type return results for all types, including tickets (and
organization is a ticket property).</p>
<p class="p">Using <code class="ph codeph">type:user</code>, your search returns all users that
belong to the Customers organization. So, you're narrowing your
search to the user type and excluding tickets. </p>
<p class="p">While organizations and groups are properties of the user object, they
have their own properties that can be searched as well. The
following query allows you search only for organization tags,
excluding tags of the same name that may be used in other elements
of your Zendesk Support instance such as tickets and forum
topics.</p>
<div class="p">
<pre class="pre codeblock"><code>type:organization tags:premium</code></pre>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title13" class="topic nested1" id="topic_ngr_frb_vc">
<h2 class="title topictitle2" id="ariaid-title13">Search operators</h2>
<div class="body">
<div class="p">You can use the following search operators to build your search
statements.<div class="note important">
<span class="importanttitle">Important:</span> When using operators in
your search queries, you must not enter a space
before or after the operator. For example, entering
<code class="ph codeph">updated&lt;2025-07-04</code> uses
“updated” as the operator, while <code class="ph codeph">updated &lt;
2025-07-04</code> searches for the word
“updated”.</div>
</div>
<div class="p">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_ngr_frb_vc__table_icl_wqh_21b" rules="all" summary="">
<caption><span class="tablecap"><span class="table--title-label">Table 1. </span>Search operators</span></caption>
<colgroup>
<col style="width:16.5016501650165%">
<col style="width:83.4983498349835%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry nocellnorowborder" id="d51e820" style="vertical-align:top;">Operator</th>
<th class="entry cell-norowborder" id="d51e823" style="vertical-align:top;">Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e820" style="vertical-align:top;">: </td>
<td class="entry cell-norowborder" headers="d51e823" style="vertical-align:top;">The colon indicates that the given field should equal the specified
value.<pre class="pre">status:open</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e820" style="vertical-align:top;">&lt;</td>
<td class="entry cell-norowborder" headers="d51e823" style="vertical-align:top;">Less than. <pre class="pre">status&lt;closed</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e820" style="vertical-align:top;">&gt;</td>
<td class="entry cell-norowborder" headers="d51e823" style="vertical-align:top;">Greater than. <pre class="pre">priority&gt;normal</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e820" style="vertical-align:top;">&lt;=</td>
<td class="entry cell-norowborder" headers="d51e823" style="vertical-align:top;">Less than or equal to. <pre class="pre">status&lt;=pending</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e820" style="vertical-align:top;">&gt;=</td>
<td class="entry cell-norowborder" headers="d51e823" style="vertical-align:top;">Greater than or equal to. <pre class="pre">priority&gt;=normal</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e820" style="vertical-align:top;">" "</td>
<td class="entry cell-norowborder" headers="d51e823" style="vertical-align:top;">Double quotes. In a simple keyword search, this is referred to as a
phrase search and returns the exact words in the exact order; however,
punctuation characters are not
included.<pre class="pre">"Please upgrade my account"</pre>
<div class="note note">
<span class="notetitle">Note:</span> In
the Japanese version of Support, this feature does not work as
expected. A simple keyword search that includes double quotes
returns results, but the results are not the exact words in the
exact order.</div>
<p class="p">In a search including data
properties, use double quotes to perform an inclusive AND search,
returning results that include <em class="ph i">all</em> properties in the search. </p>
<div class="p">
<pre class="pre">tags:"superman is_awesome"</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e820" style="vertical-align:top;">- </td>
<td class="entry cell-norowborder" headers="d51e823" style="vertical-align:top;">Minus sign. Excludes items containing a word (or property value) from
the search results. For example, the following statement searches for
any tickets with the status 'pending', but excludes any tickets
containing the tag 'invoice' from the search results:
<pre class="pre">status:pending -tags:invoice </pre>
</td>
</tr>
<tr class="row">
<td class="entry row-nocellborder" headers="d51e820" style="vertical-align:top;">*</td>
<td class="entry cellrowborder" headers="d51e823" style="vertical-align:top;">The wildcard operator is useful when you want to search various forms
of a word. For example, searching for <code class="ph codeph">photo*</code> returns
results that would include photography, photographer, photograph and any
other words that began with 'photo'. <div class="p">However, because of the
performance issues involved with doing wildcard searches,
unqualified wildcard searches are not currently supported. In other
words, you need to use a property keyword to make your search
specific to the data you're trying to locate.
<pre class="pre">subject:photo*</pre>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title14" class="topic nested1" id="topic_crj_yev_uc">
<h2 class="title topictitle2" id="ariaid-title14">Ticket property keywords</h2>
<div class="body">
<p class="p">You can search the following ticket properties. </p>
<p class="p">For more information about ticket search, see the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408882086298" target="_blank">search reference for tickets</a>.</p>
<div class="p">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_crj_yev_uc__table_uc2_drh_21b" rules="all" summary="">
<caption><span class="tablecap"><span class="table--title-label">Table 2. </span>Searchable ticket properties</span></caption>
<colgroup>
<col style="width:16.666666666666664%">
<col style="width:83.33333333333334%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry nocellnorowborder" id="d51e970" style="vertical-align:top;">Keyword</th>
<th class="entry cell-norowborder" id="d51e972" style="vertical-align:top;">Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;">Ticket ID</td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">There isn't a property keyword for the ticket ID. Instead, you simply
search for the ticket by its ID number in the following format:<div class="p">
<pre class="pre">233</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">created</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The date, or date and time, the ticket was created. Enter date in
yyy-mm-dd format. <div class="p">
<pre class="pre">created:2011-05-01</pre>
</div>
<p class="p">Search within a date or time range. Enter times using <a class="xref" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a> syntax. For example, to search
for a ticket created between 10:30 a.m. and 12 p.m. (UTC) on August
1, 2014:</p>
<div class="p">
<pre class="pre">created&gt;2014-08-01T10:30:00Z created&lt;2014-08-01T12:00:00Z</pre>
</div>
<p class="p">For more information on using date and time in your search, see
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_ghr_wsc_3v" target="_blank">Searching by date and
time</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">updated</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The date of the most recent ticket update. <div class="p">
<pre class="pre">updated&gt;2011-05-15</pre>
</div>
<p class="p">For more information on using date and time in your search, see
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_ghr_wsc_3v" target="_blank">Searching by date and
time</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">solved</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The date the ticket was set to solved. <div class="p">
<pre class="pre">solved&lt;2011-06-01</pre>
</div>
<p class="p">For more information on using date and time in your search, see
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_ghr_wsc_3v" target="_blank">Searching by date and
time</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">due_date</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The due date of tickets. <div class="p">
<pre class="pre">due_date:2011-06-01</pre>
</div>
<p class="p">For more information on using date and time in your search, see
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_ghr_wsc_3v" target="_blank">Searching by date and
time</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">assignee</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The assigned agent or other entity. You can specify "none", "me",
user name (full name or partial), email address, user ID, or phone
number (see the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_rvz_afv_uc" target="_blank"><code class="ph codeph">phone</code> user
property</a> for help searching by phone number).<div class="p">
<pre class="pre">assignee:"Susan Warren"</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">submitter</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The ticket submitter. This may be different than the requester if the
ticket was submitted by an agent on behalf of the requester. You can
specify "none", "me", user name (full name or partial), email address,
user ID, or phone number (see the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_rvz_afv_uc" target="_blank"><code class="ph codeph">phone</code> user
property</a> for help searching by phone number). See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408882086298#topic_xca_cjv_uc" target="_blank">Searching ticket user roles</a>. <div class="p">
<pre class="pre">submitter:me</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">requester</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The ticket requester. You can specify "none", "me", user name (full
name or partial), email address, user ID, or phone number (see the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_rvz_afv_uc" target="_blank"><code class="ph codeph">phone</code> user
property</a> for help searching by phone number).<div class="p">
<pre class="pre">requester:amy@mondocam.com</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">subject</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The text in the ticket's subject. <div class="p">
<pre class="pre">subject:"upgrade account"</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">description</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The text in the ticket's description. The description is the first
comment in the ticket, whether it's public or internal. It does not
include the text from the subject line of the ticket.<div class="p">
<pre class="pre">description:defective</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">custom_status_id</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">If <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4412575841306" target="_blank">custom ticket statuses are
activated</a>, search for a specific system or custom ticket
status. Specify the status by its numeric ID, which you can find on the
Ticket statuses page when <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4412575941402#topic_wqd_t1h_vrb" target="_blank">editing a ticket status</a>.<div class="p">
<pre class="pre codeblock"><code>custom_status_id:2393906</code></pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">status</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Possible values: new, open, pending, hold, solved, closed. <div class="p">
<pre class="pre">status&lt;closed</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">ticket_type</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Possible values: question, incident, problem, task. <div class="p">
<pre class="pre">ticket_type:problem</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">support_type</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">
<p class="p" dir="ltr">(Applicable only for messaging tickets) Indicates whether a
ticket was handled entirely by an AI agent or whether a human agent
was involved. Possible values: ai_agent, agent.</p>
<p class="p" dir="ltr">For more information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9204149016346" target="_blank">Understanding and viewing AI
agent tickets for AI agent–only conversations</a>.</p>
<div class="p" dir="ltr">
<pre class="pre">support_type:ai_agent</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">priority</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Possible values: low, normal, high, urgent.
<pre class="pre">priority&gt;low</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">group</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Specify the name or ID of a group. Returns tickets assigned to agents
who are members of the group. Examples:<div class="p">
<pre class="pre">group:"Level 2"</pre>
</div>
<div class="p">
<pre class="pre">group:20663166</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">organization</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Specify the name or ID of an organization. Returns tickets by
requesters who are members of the organization. Examples:<div class="p">
<pre class="pre">organization:customers</pre>
</div>
<div class="p">
<pre class="pre">organization:22989442</pre>
</div>
<p class="p">You can also specify "none" to return tickets by requesters who
are not members of any organization.</p>
<div class="p">
<pre class="pre">organization:none</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">tags</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Specify tags that have been added to the ticket or "none."<div class="p">
<pre class="pre">tags:premium</pre>
</div>
<p class="p">To find tickets that include either of two tags, use:</p>
<div class="p">
<pre class="pre">tags:important tags:urgent</pre>
</div>
<p class="p">To find tickets that include both tags:</p>
<div class="p">
<pre class="pre">tags:"important urgent"</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">via</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">The ticket's source, for example:<ul class="ul" id="topic_crj_yev_uc__d9e398">
<li class="li">mail (from an email message)</li>
<li class="li">get_satisfaction, get_sat, "get satisfaction" (from Get
Satisfaction)</li>
<li class="li">closed_ticket (from a followup ticket)</li>
<li class="li">ticket_sharing</li>
<li class="li">dropbox (from the Zendesk Feedback Tab)</li>
<li class="li">chat (from Chat)</li>
<li class="li">twitter_dm, "twitter dm", "twitter direct" (from a Twitter
direct message)</li>
<li class="li">twitter_fav, twitter_favorite, "twitter favorite" (from a
Twitter favorite)</li>
<li class="li">twitter_like, "twitter like" (from a Twitter like; alias of
twitter_fav)</li>
<li class="li">twitter (from any Twitter method including direct message and
favorite)</li>
<li class="li">voicemail (from a voicemail message)</li>
<li class="li">phone_call_inbound (from an inbound phone call)</li>
<li class="li">phone_call_outbound (from an outbound phone call)</li>
<li class="li">phone (from voicemail, CTI, or an inbound call)</li>
<li class="li">sms, text, "text message" (from a text message)</li>
<li class="li">api (from API call or integrated web service)</li>
<li class="li">logmein, logmein_rescue, "logmein rescue" (from LogMeIn)</li>
<li class="li">facebook_post, "facebook post" (from a Facebook wall post to a
page)</li>
<li class="li">facebook_message, "facebook message" (from a Facebook private
message to a page)</li>
<li class="li">facebook (from any Facebook method including private message and
wall post)</li>
<li class="li">web, "web form" (from a web form)</li>
<li class="li">mobile_sdk (tickets created using the Zendesk mobile SDK)</li>
<li class="li">"any_channel" (from the channel framework)</li>
<li class="li">native_messaging (from the messaging channel)</li>
<li class="li">side_conversation (from a side conversation)</li>
<li class="li">sunshine_conversations_facebook_messenger
</li>
<li class="li">answer_bot_for_web_widget (from Answer bot tickets)</li>
</ul>
<div class="p">
<pre class="pre">via:phone</pre>
</div>
<p class="p">For a full list of sources, see <a class="xref" href="https://developer.zendesk.com/documentation/ticketing/reference-guides/via-types/" target="_blank">Via types reference in the
Zendesk developer documentation</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">commenter</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">People who have added comments to tickets. You can specify "none",
"me", user name (full name or partial), email address, user ID, or phone
number (see the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_rvz_afv_uc" target="_blank"><code class="ph codeph">phone</code> user
property</a> for help searching by phone number).<div class="p">
<pre class="pre">commenter:"Mike"</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">cc</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">People who have been CC'd on tickets. You can specify "none", "me",
user name (full name or partial), email address, user ID, or phone
number (see the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886879258#topic_rvz_afv_uc" target="_blank"><code class="ph codeph">phone</code> user
property</a> for help searching by phone number).<div class="p">
<pre class="pre">cc:amanda@mondocam.com</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">fieldvalue</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Search for a specific value in any custom ticket fields by using the
<samp class="ph systemoutput">fieldvalue</samp> keyword. For example:<div class="p">
<pre class="pre">fieldvalue:12345</pre>
</div>
<p class="p">This returns all the tickets that have a custom field with the
value "12345."</p>
<p class="p">For drop-down custom fields, search for tags
associated with the field value you want to find. </p>
<p class="p">For
checkbox custom fields, you can search for tickets with the field
checked or unchecked. For example:</p>
<div class="p">
<pre class="pre">custom_field_&lt;Field ID&gt;:checked</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">custom_field_{id}</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Search for a value of a specific custom ticket field. Specify the
field by its numeric ID, which you can get from the URL of the Ticket
Fields page in the admin interface or with the <a class="xref" href="https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_fields/" target="_blank">Ticket Fields</a> API. The syntax
is <code class="ph codeph">custom_field_&lt;custom field ID&gt;:&lt;value&gt;</code>. Example:<div class="p">
<pre class="pre codeblock"><code>custom_field_455214213:shoes</code></pre>
</div>
<p class="p">See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408882086298#topic_wly_fev_uc" target="_blank">Searching custom ticket
fields</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">brand</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Search for a specific brand on a ticket using the brand name or the
brand ID. A brand with two or more words requires quotation marks. For
example:<pre class="pre">brand:Nordstrom</pre>
<div class="p">Or<pre class="pre">brand: "Banana Republic"</pre>
</div>
<p class="p">Or</p>
<pre class="pre">brand:&lt;<em class="ph i">ID number</em>&gt;</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">has_attachment</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Search for all tickets with or without attachments using
<code class="ph codeph">true</code> or <code class="ph codeph">false</code>. <p class="p">To search for
tickets with
attachments:</p>
<pre class="pre codeblock"><code>has_attachment:true</code></pre>
<p class="p">To
search for all tickets without
attachments:</p>
<pre class="pre codeblock"><code>has_attachment:false</code></pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">form</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Search for all tickets created with a particular ticket form.<p class="p">If
the name of the ticket form includes multiple words, use quotation
marks. For
example:</p>
<pre class="pre codeblock"><code>form:"default ticket form"</code></pre>
<p class="p">If
the name of the ticket form is a single word, you don't have to use
the quotation marks. For
example:</p>
<pre class="pre codeblock"><code>form:legal</code></pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">recipient</code></td>
<td class="entry cell-norowborder" headers="d51e972" style="vertical-align:top;">Search for all tickets created with a particular recipient.<div class="p">This
only works for Zendesk support addresses (the ultimate destination)
of emails forwarded from external
addresses.<pre class="pre codeblock"><code>recipient:support@<em class="ph i">yoursubdomain</em>.zendesk.com</code></pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry row-nocellborder" headers="d51e970" style="vertical-align:top;"><code class="ph codeph">comment</code></td>
<td class="entry cellrowborder" headers="d51e972" style="vertical-align:top;">Search for text within a ticket's
comment.<pre class="pre codeblock"><code>comment:fancy</code></pre>
<p class="p">To search for an
exact match within the comments of a ticket, use double
quotes.</p>
<pre class="pre codeblock"><code>comment:"fancy things here"</code></pre>
<div class="note note">
<span class="notetitle">Note:</span> Only
the first 500 comments in a ticket are
searched.</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title15" class="topic nested1" id="topic_rvz_afv_uc">
<h2 class="title topictitle2" id="ariaid-title15">User property keywords</h2>
<div class="body">
<p class="p">You can search the following user properties. </p>
<p class="p">For more information about searching users, see the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408883318554" target="_blank">search reference for users, groups, and
organizations</a>.</p>
<div class="p">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_rvz_afv_uc__table_mcw_frh_21b" rules="all" summary="">
<caption><span class="tablecap"><span class="table--title-label">Table 3. </span>User property keywords</span></caption>
<colgroup>
<col style="width:16.666666666666664%">
<col style="width:83.33333333333334%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry nocellnorowborder" id="d51e1689" style="vertical-align:top;">Keyword</th>
<th class="entry cell-norowborder" id="d51e1691" style="vertical-align:top;">Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">name</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">The user's partial or full name.
<pre class="pre">name:"alex anderson"</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">role</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">The user's designated role.<pre class="pre">role:admin</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">email</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Specify the user's email address, or specify none to search for users
without an email address.
<pre class="pre">email:alex@mondocam.com</pre>
<pre class="pre">email:"none"</pre>
<div class="p">Using
double quotes to search for an email address does not return an
exact match like other keyword searches. For example, if you search
the following the results may return any user whose email starts
with "dwight":<pre class="pre codeblock"><code>email:"dwight@mondocam.com"</code></pre>
</div>
<div class="p">
<div class="note tip">
<span class="tiptitle">Tip:</span> Wildcards do not work for email address searches.
For example, the following search returns no
results:<pre class="pre">email:dwight*</pre>
</div>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">group</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">The user's group name. This only applies to admin and agent users.
<pre class="pre">group:"Level 2"</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">organization</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Specify the user's organization name or ID, or specify
<code class="ph codeph">none</code> to search for users without an organization.
If the user belongs to more than one organization, searching on any of
those organizations will return their
profile.<pre class="pre">organization:mondocam</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">created</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">The date the user was added to your Zendesk.
<pre class="pre">created&lt;2011-05-01</pre>
<p class="p">For more information on using
date and time in your search, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408835086106#topic_gbg_dvw_ld" target="_blank">Searching by date and
time</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">notes</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">All text in the notes field in the user's profile.
<pre class="pre">notes:"manager"</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">details</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">All text in the details field in the user's profile.
<pre class="pre">details:"madison, wi"</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">external_id</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Specify the user's external ID, if used, or
specify<code class="ph codeph">none</code> to search for users without an external
ID. <pre class="pre">external_id:0098884412</pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">phone</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Specify the user's phone number, or specify <code class="ph codeph">none</code> to
search for users without a phone number.
<pre class="pre">phone:+555-111-2222</pre>
<p class="p">When searching by phone number, you
must include a plus sign (+) before the number. When searching by
phone number using the API, you must include %2B (the URL-encoded
version of +) before the number (for example,
<code class="ph codeph">/api/v2/search?query=type:phone:%2B555-111-2222</code>).</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">tags</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Specify tags on the user's profile, or specify <code class="ph codeph">none</code>
to search for users without tags.
<pre class="pre">tags:premium tags:wholesale</pre>
For more information about tagging
users and organizations, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408881573658" target="_blank">Adding tags to users and
organizations</a>.</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">customfield</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Custom user fields.<div class="p">
<pre class="pre">plan_type:platinum</pre>
For more
information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408883318554#topic_pyt_m1s_vk" target="_blank">Searching custom user and
organization fields</a>.</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">is_verified</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Indicates whether any of a user's identities have been verified.
Users with any verified identity, not just an email address, are
included in the search results. For example, users with verified phone
numbers are listed. <ul class="ul" id="topic_rvz_afv_uc__d10e225">
<li class="li" dir="ltr">
<p class="p" dir="ltr"><strong class="ph b">is_verified:false Sunita</strong> returns all users
named Sunita who do not have a verified identity.</p>
</li>
<li class="li" dir="ltr">
<p class="p" dir="ltr"><strong class="ph b">is_verified:true</strong> returns all users with a
verified identity.</p>
</li>
</ul>
<p class="p">Any user created via <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408893967514" target="_blank">ticket sharing</a> is
automatically verified.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">is_suspended</code></td>
<td class="entry cell-norowborder" headers="d51e1691" style="vertical-align:top;">Indicates whether the user has been suspended.<ul class="ul" id="topic_rvz_afv_uc__d10e258">
<li class="li" dir="ltr">
<p class="p" dir="ltr"><strong class="ph b">is_suspended:true Sunita</strong> returns all users
named Sunita who have been suspended.</p>
</li>
<li class="li" dir="ltr">
<p class="p" dir="ltr"><strong class="ph b">is_suspended:true</strong> returns all users who have
been suspended.</p>
</li>
</ul>
</td>
</tr>
<tr class="row">
<td class="entry row-nocellborder" headers="d51e1689" style="vertical-align:top;"><code class="ph codeph">whatsapp</code></td>
<td class="entry cellrowborder" headers="d51e1691" style="vertical-align:top;">Search for users based on a WhatsApp phone number.<p class="p">For more
information see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5869718332954" target="_blank">Searching for tickets by WhatsApp
number</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title16" class="topic nested1" id="topic_gok_ffv_uc">
<h2 class="title topictitle2" id="ariaid-title16">Organization property keywords</h2>
<div class="body">
<p class="p">You can search the following organization properties </p>
<p class="p">For more information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408883318554" target="_blank">Searching for users, groups, and
organizations</a>. </p>
<div class="p">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_gok_ffv_uc__table_vks_hrh_21b" rules="all" summary="">
<caption><span class="tablecap"><span class="table--title-label">Table 4. </span>Organization property keywords</span></caption>
<colgroup>
<col style="width:16.666666666666664%">
<col style="width:83.33333333333334%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry nocellnorowborder" id="d51e1998" style="vertical-align:top;">Keyword</th>
<th class="entry cell-norowborder" id="d51e2000" style="vertical-align:top;">Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1998" style="vertical-align:top;"><code class="ph codeph">name</code></td>
<td class="entry cell-norowborder" headers="d51e2000" style="vertical-align:top;">The organization's partial or full name.<div class="p">
<pre class="pre">name:mondocam</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1998" style="vertical-align:top;"><code class="ph codeph">created</code></td>
<td class="entry cell-norowborder" headers="d51e2000" style="vertical-align:top;">The date the organization was added. <pre class="pre">created&lt;2011-05-01</pre>
<p class="p">For more information
on using date and time in your search, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408835086106#topic_gbg_dvw_ld" target="_blank">Searching by date and
time</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1998" style="vertical-align:top;"><code class="ph codeph">notes</code></td>
<td class="entry cell-norowborder" headers="d51e2000" style="vertical-align:top;">All text in the notes field in the user's profile. <div class="p">
<pre class="pre">notes:EMEA</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1998" style="vertical-align:top;"><code class="ph codeph">details</code></td>
<td class="entry cell-norowborder" headers="d51e2000" style="vertical-align:top;">All text in the details field in the organization's profile.<div class="p">
<pre class="pre">details:london</pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1998" style="vertical-align:top;"><code class="ph codeph">tags</code></td>
<td class="entry cell-norowborder" headers="d51e2000" style="vertical-align:top;">Specify
tags
that have been added to the
organization,
or specify <code class="ph codeph">none</code> to search for organizations without
tags. <pre class="pre">tags:premium</pre>
<p class="p">For more information
about tagging users and organizations, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408881573658" target="_blank">Adding tags to users and
organizations</a>.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e1998" style="vertical-align:top;"><code class="ph codeph">customfield</code></td>
<td class="entry cell-norowborder" headers="d51e2000" style="vertical-align:top;">Custom organization fields.<div class="p">
<pre class="pre">plan_type:platinum</pre>
For more
information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408883318554#topic_pyt_m1s_vk" target="_blank">Searching custom user and
organization fields</a>.</div>
</td>
</tr>
<tr class="row">
<td class="entry row-nocellborder" headers="d51e1998" style="vertical-align:top;"><code class="ph codeph">external_id</code></td>
<td class="entry cellrowborder" headers="d51e2000" style="vertical-align:top;">The external ID of the organization or specify <strong class="ph b">none</strong> to search
for users without an external ID.<div class="p">
<pre class="pre">external_id:00112345</pre>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title17" class="topic nested1" id="topic_wcx_ifv_uc">
<h2 class="title topictitle2" id="ariaid-title17">Group property keywords</h2>
<div class="body">
<p class="p">You can search the following group properties. </p>
<p class="p">For more information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408883318554" target="_blank">Searching for users, groups, and
organizations</a>. </p>
<div class="p">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_wcx_ifv_uc__table_xyc_lrh_21b" rules="all" summary="">
<caption><span class="tablecap"><span class="table--title-label">Table 5. </span>Group property keywords</span></caption>
<colgroup>
<col style="width:16.666666666666664%">
<col style="width:83.33333333333334%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry nocellnorowborder" id="d51e2144" style="vertical-align:top;">Keyword</th>
<th class="entry cell-norowborder" id="d51e2146" style="vertical-align:top;">Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e2144" style="vertical-align:top;"><code class="ph codeph">name</code></td>
<td class="entry cell-norowborder" headers="d51e2146" style="vertical-align:top;">The group's name.<pre class="pre">name:"level 2"</pre>
</td>
</tr>
<tr class="row">
<td class="entry row-nocellborder" headers="d51e2144" style="vertical-align:top;"><code class="ph codeph">created</code></td>
<td class="entry cellrowborder" headers="d51e2146" style="vertical-align:top;">The date the group was added. <div class="p">
<pre class="pre">created&lt;2011-05-01</pre>
</div>
<p class="p">For more information on using date and time in your search, see
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408835086106#topic_gbg_dvw_ld" target="_blank">Searching by date and
time</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title18" class="topic nested1" id="topic_nms_sgd_jf">
<h2 class="title topictitle2" id="ariaid-title18">Satisfaction rating searchable values</h2>
<div class="body">
<p class="p">You can use the <code class="ph codeph">satisfaction</code> keyword with rating values
to search your customer satisfaction ratings. </p>
<p class="p">For more information on customer satisfaction, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886173338" target="_blank">Using customer satisfaction
rating</a>.</p>
<div class="p">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_nms_sgd_jf__table_nis_rhd_jf" rules="all" summary="">
<caption><span class="tablecap"><span class="table--title-label">Table 6. </span>Satisfaction rating keywords</span></caption>
<colgroup>
<col style="width:16.666666666666664%">
<col style="width:83.33333333333334%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry nocellnorowborder" id="d51e2215" style="vertical-align:top;">Value</th>
<th class="entry cell-norowborder" id="d51e2218" style="vertical-align:top;">Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e2215" style="vertical-align:top;"><code class="ph codeph">bad</code></td>
<td class="entry cell-norowborder" headers="d51e2218" style="vertical-align:top;">Tickets that have been rated 'bad'. <div class="p">
<pre class="pre codeblock"><code>satisfaction:bad</code></pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e2215" style="vertical-align:top;"><code class="ph codeph">badwithcomment</code></td>
<td class="entry cell-norowborder" headers="d51e2218" style="vertical-align:top;">Tickets that have been rated 'bad' that
also include a comment from the ticket
requester.<pre class="pre codeblock"><code>satisfaction:badwithcomment</code></pre>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e2215" style="vertical-align:top;"><code class="ph codeph">good</code></td>
<td class="entry cell-norowborder" headers="d51e2218" style="vertical-align:top;">Tickets that have been rated 'good'.<div class="p">
<pre class="pre codeblock"><code>satisfaction:good</code></pre>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d51e2215" style="vertical-align:top;"><code class="ph codeph">goodwithcomment</code></td>
<td class="entry cell-norowborder" headers="d51e2218" style="vertical-align:top;">Tickets that have been rated 'good' that
also include a comment from the ticket
requester.<pre class="pre codeblock"><code>satisfaction:goodwithcomment</code></pre>
</td>
</tr>
<tr class="row">
<td class="entry row-nocellborder" headers="d51e2215" style="vertical-align:top;"><code class="ph codeph">offered</code></td>
<td class="entry cellrowborder" headers="d51e2218" style="vertical-align:top;">When you request a customer satisfaction
rating, the ticket satisfaction rating status is
set to 'offered'. The following notification is
added to the ticket: Customer satisfaction
feedback was offered. This means that you've asked
for but not yet received a response to the rating
request. <div class="p">
<pre class="pre codeblock"><code>satisfaction:offered</code></pre>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408886879258",
"url": "https://support.zendesk.com/hc/en-us/articles/4408886879258",
"headline": "Zendesk Support search reference",
"description": "You can use specific data property keywords, operators, and search terms to perform advanced searches and narrow results in your support data, including tickets, users, organizations, and groups, with detailed guidance on syntax and examples.",
"articleSection": "Ticket basics",
"datePublished": "2021-10-16T16:27:08+00:00",
"dateModified": "2026-08-04T22:31:21.739933+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408886879258"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script>
</body>