In addition to full text search, you can search using common search operators combined with data property keywords and values to narrow your results.
This article describes how Zendesk Support's advanced search works. It is aimed at administrators and managers with full access to the data in Zendesk Support. Use this article in conjunction with theZendesk Support search reference, which contains tables listing and describing the full set of keywords and values you can use when searching tickets, users, and the like.
If you're an agent, or want to know more about basic search, start withSearching the data in Zendesk Supportand refer back to this reference article if you want to perform more advanced searches.
Topics covered in this article:
Performing an advanced search
You can perform an advanced search from your Zendesk agent interface.
执行高级搜索
- Click theSearchicon (
) in the upper-right of the top toolbar. You can also hover your mouse over the+Addbutton and chooseSearchfrom the drop-down menu. - Enter your search terms, using the terminology, operators, and formatting described in the sections below.
- When the search results appear, click theTickets,Users,Articles, orOrganizationstab to filter the results.
Advanced search terms and terminology
Advanced search allows you to narrow your results by usingdata property keywords,operators, andsearch terms. In the context of an advanced search:
- Data property keywordsindicate that you are restricting a search to one or more specific data properties.
- Operatorsare symbols used to modify the keywords and focus the search.
- Search termsare the words, phrases, or values you are searching for.
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 will also include other data in your Zendesk Support instance that match the term "vip." For instance, if an organization has "vip" in its name, like "Midwest VIP Transportation" or "Viper Reptile Supplies," even if it does not have the VIP tag, it will appear in your search results.
The following is an example of a search string looking for anything with the tag "vip" that was created before May 1, 2015:
tags:vip created<2015-05-01- tagsis a keyword indicating you are searching only within a specific data property, in this case atag.
- :is an operator indicating thetagproperty needs to match the subsequent search term. Note that there is no space before or after the:.
- vipis the search term referred to by the prior property/operator combination.
- createdis a keyword indicating you are searching thecreateddata property for items created relative to a certain date.
- <is an operator indicating you are searching for users, tickets, organizations, or articles created before a certain date.
- 2015-05-01is a search term indicating the date you want to use.
Please upgrade my account
However, when you use a data property keyword multiple times in a query, there is an OR search across the values you specified. The following phrase returns results that containeitherthe tag "silver" or the tag "bronze".
tags:silver tags:bronze
执行和搜索在多个数据属性keywords, wrap the keywords in double quotes. The following phrase only returns results that containbothtags, "superman" and "is_awesome".
tags:"superman is_awesome"
Search operators
The following search operators can be used to build your search statements.
| Operator | Description |
|---|---|
| : | The colon indicates that the given field should equal the specified value.状态:开放 |
| < | Less than.status |
| > | Greater than.priority>normal |
| <= | Less than or equal to.status<=pending |
| >= | Greater than or equal to.priority>=normal |
| " " | 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."Please upgrade my account"
Note: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. In a search including data properties, use double quotes to perform an inclusive AND search, returning results that includeallproperties in the search. tags:"superman is_awesome" |
| - | 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:status:pending -tags:invoice |
| * | 通配符操作符r is useful when you want to search various forms of a word. For example, searching forphoto*returns results that would include photography, photographer, photograph and any other words that began with 'photo'.
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. subject:photo* |
Searching for properties that contain no data
noneas the search term, along with thegroup,tags,via,organization, orassigneekeywords, as in this example:assignee:none
This returns all unassigned tickets.
Searching by date and time
Date property keywords -created,updated,solved, anddue date) 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.
created<2011-05-01
due_date>2010-01-10
solved:2010-01-10
You can also use the<=or>=operators to indicateless-than-or-equal-toandgreater-than-or-equal-torespectively.
Searching with combined dates and times
created>2015-09-01T12:00:00-08:00 updated<2015-09-01T12:00:00Z
The first example above searches for anything created after September 1, 2015 at 12:00 p.m. (Pacific Standard Time).
The second example above searches for anything updated before September 1, 2015 at 12:00 p.m. (UTC).
Searching within a date/time range
created>2014-08-01 created<2014-08-05
你还可以包括特定时间搜索range. The following example searches for anything created between August 1, 2014 at 11:59 p.m. (UTC) and August 2, 2014 at midnight (UTC):
created>2014-08-01T11:59:00Z created<2014-08-05T24:00:00Z
Searching with relative times
You can search for a time relative to the present time, using the time unitshours,minutes,days,weeks,months, oryears. The following search returns anything created in the last four hours:
created>4hours
Searching for tickets with a specific ticket form
You can search for a ticket form and get results for all tickets where that ticket form is applied. For example, the following search returns all tickets that use the Change Request ticket form:
form:"Change Request"Sorting search results
You can sort your search results by field, in ascending or descending order, using the following keyword phrases:
order_by:fieldsort:ascorsort:desc
Sorting is available on the following fields:
createdcommentedprioritystatusticket_type
Using theorder_byandsortkeywords is equivalent to using the API parameterssort_byandsort_order.
Using the 'type' keyword
For API searches, one of the tools you have available for narrowing your search results is thetypekeyword. It is used to explicitly declare that you want to search for one of the following types:
- ticket
- user
- organization
- group
- article (Help Center)
- entry or topic (forums)
Using thetypekeyword 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:
type:user organization:customersIf you instead searched fororganization:customersyou 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).
Usingtype:user, your search returns all users that belong to the Customers organization. So, you're narrowing your search to the user type and excluding tickets.
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 Zendesk Support such as tickets and forum topics.
type:organization tags:premiumSuspended and verified users
You can search for users based on whether or not they are suspended, and whether or not they are 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.
To search for suspended users:
is_suspended:trueis_verified:trueSearch FAQ
- How soon can new data be searched?
When you add new data to Zendesk Support, it typically takes about a minute before it's indexed and can be searched. If you have theZendesk Agent Workspaceenabled on your account, you can also searchlive chat and messaging conversations, but it can take 10 to 12 minutes before a conversation is indexed.
- 标点符号是如何影响搜索?
Punctuation characters are generally not included in searches.
- Are there limitations to wildcard searches?
You can only do wildcard searches when combined with property keywords (
subject:photo*). The wildcard must go at the end of the search term. - Who can search what?
Administrators can search all the data in Zendesk Support. Agents can search the data that they've been granted access to. End-users can do full text searches of the knowledge base.
What languages are supported?
There is language-specific support for searching in the following languages:- Brazilian Portuguese
- Dutch
- English
- French
- German
- Italian
- Japanese
- Korean
- Russian
- Spanish
The support includes dictionary-based tokenization for Japanese, because words are not separated by spaces in that language. For the other languages, the language-specific support is primarily stemming, which allows different forms of the same word to match. In particular, the singular and plural forms of a word will generally match.
19 Comments
It seems that the change of where the Advanced Search was located has caused odd behavior with the new simple search - has anyone else experienced this?
When we enter our search if we hit enter it works perfectly, however, if we hit the search icon itself our entry is completely deleted and no search is activated.
It seems like this is leftover from when the icon helped you get to Advanced Search and is now doing an action it shouldn't be (removing search text/reloading search).
Has anyone else experienced this or is this completely unrelated?
Hi Morgan,
I just want to make sure I understand – so you're talking about clicking the search icon once to open the search text box, entering your search terms, and then clicking the search icon again (which at that point is inside the search text box)?
Ah, I see it looks like your colleague Meg entered the same thing in our product feedback forums:Search Icon, reloads search widget. I'll see what I can find out.
I didn't see it in the article, but can someone confirm whether we're able to search by what channel the ticket originated? For instance, looking for tickets which came from messaging?
Thank you for messaging us.
If you are using the standard search function, the information about channels is not available. However, you can useZendesk Exploreto create a report by channels. However, if you are only checking single tickets you can check them byevents.
Best,
Hello,
I am looking to create a query that combines two parameters and the result should be all the tickets that meet either of the two criteria im putting in the query (almost like having an OR operand).
The query im using is updated:2021-12-22 created:2021-12-22 , but this is being treated as an exclusive (AND) query returning only the tickets that meet both criteria and not either of them. Any idea how i can accomplish what i'm looking for?
Thanks in advance.
Hector
Unfortunately,it is not possible to use AND or OR as operators in an advanced search.
Although, if you are using 2 values of a field that doesn't accept multiple values the system automatically understands you are searching for one value OR theother(e.g. status:open status:new), in the example youprovidedit is impossible to receive a responsetheway you are looking for (Tickets created on 2021-12-22 OR Tickets updated on 2021-12-22).
Please feel free to post any other questions you may have.
Hi Hector,
Of course in your case, if a ticket is created on 2021-12-22 it is also updated on the same day. The updatedAt date is automatically populated on ticket creation.
So you could just use one criteria: updated:2021-12-22 and you should get what you want. (tickets updated on that day, which includes ticket created on that day).
Hope this helps.
Adrien.
Hi
Can we adjust the options in Via?
I want to check tickets from Google Play, but there is no clear option
It looks like we do not have any options to edit the "via" option in the advanced search app to include tickets from Google Play at the moment.
Regards,
Dion
I want to search users by custom fields. I am using the query ::
.../api/v2/search.json?query=type:user custom_field_
replacing by my custom field id and by search value but it is not giving me any data:
No ability to search for a specific mail domain?
I'm looking for all ticket requestors that use a mail address with a specific mail domain - to identify users which should belong to the company (organization), but are currently not assigned to the organization.
Currently the search for phrase (" ") operator does not ensure that the format domain.tld is used, but it searches for the two words next to each other.
It would be needed to
1) Have a search that will only look into the mail addres of the user
2) Have a phrase search that works letter by letter - means that no altering of the search phrase is done, no fuzzy search
You can refer toSearching for users by email domain.
Hi Asmita,
Please refer toSearching custom user and organization fields.
Hi, Why is the app fiels in french and english mixed up together ?
How to search for all agents excluding light agents and admins?
HiSebastian,
You can try searching using this:
The list includes light agents as well.
HiClaudia L,
I created a ticket on your behalf, and I’ll continue to assist you from there. Kindly check your email for updates. Thank you!
Ok thanks a million
Hello! I'd need some help with the advanced search. As you can see from the two screenshots below, when I search for a few email addresses, nothing appears in theUserstab. But under theArticlestab, there are always some articles that I have no idea why they get associated to that person (since they're all end users). In the first screenshot, searching for a user I see one of our Articles. But in the second screenshot, searching for another user I find a whole list where it's always the same article, repeated 7 times, and in Japanese (the user isn't Japanese). This happens no matter which user's email I search with. I looked in these articles' settings, and nothing has been changed from how they were before. Is it just a Zendesk technical issue or what else?
Screenshot 1:
Screenshot 2:
Pleasesign into leave a comment.