Type in one or more words (or pieces of words) to search for:
- The Basics
- Examples of Simple Queries
- Fields You Can Search On
- Advanced Features
- Advanced Shortcuts
- Examples of Complex Queries
"Is this going to be a stand-up fight, sir, or another issue hunt?"
- Private First Class William L. Hudson, "Aliens".
This is an overview of how to effectively use search in D's Bugzilla. For more general information about D's Bugzilla usage, please see the Finding Bugs page in the documentation.
The Basics
- If you just put a word or series of words in the search box, D's Bugzilla will search the Product, Component, Summary, and Comment fields for your word or words.
- Typing just a number in the search box will take you directly to the issue with that ID.
- Adding more terms narrows down the search, it does not expand it. (In other words, D's Bugzilla searches for issues that match all your criteria, not issues that match any of your criteria.)
- Searching is case-insensitive. So table, Table, and TABLE are all the same.
- D's Bugzilla does not just search for the exact word you put in, but also for any word that contains that word. So, for example, searching for "cat" would also find issues that contain it as part of other words—for example, an issue mentioning "catch" or "certificate". It will not find partial words in the Comment or Keywords fields, though—only full words are matched, there.
- By default, only open issues are searched. If you want to know how to also search closed issues, see the Advanced Shortcuts section.
- If you want to search specific fields, you do it like field:value, where field is one of the field names lower down in this document and value is the value you want to search for in that field. If you put commas in the value, then it is interpreted as a list of values, and issues that match any of those values will be searched for.
Examples of Simple Queries
Here are some examples of how to write some simple queries. Examples for more complex queries can be found lower in this page.
- All open issues where userA@company.com is in the CC list
(no need to mention open issues, this is the default):
cc:userA@company.com - All unconfirmed issues in product productA (putting the
issue status at the first position make it being automatically
considered as an issue status):
UNCONFIRMED product:productA - All open and closed issues reported by userB@company.com
(we must specify ALL as the first word, else only open issues
are taken into account):
ALL reporter:userB@company.com - All open issues with severity blocker or critical with the
target milestone set to 2.5:
severity:blocker,critical milestone:2.5 - All open issues in the component Research & Development
with priority P1 or P2 (we must use quotes for the component as its name
contains whitespaces):
component:"Research & Development" priority:P1,P2
Fields You Can Search On
You can specify any of these fields like field:value in the search box, to search on them. You can also abbreviate the field name, as long as your abbreviation matches only one field name. So, for example, searching on stat:VERIFIED will find all issues in the VERIFIED status. Some fields have multiple names, and you can use any of those names to search for them.
For custom fields, they can be used and abbreviated based on the part of their name after the cf_ if you'd like, in addition to their standard name starting with cf_. So for example, can be referred to as , also. However, if this causes a conflict between the standard D's Bugzilla field names and the custom field names, the standard field names always take precedence.
Field | Field Name(s) For Search |
---|---|
mentor | |
%Complete | percentage_complete |
Alias | alias |
Any field | anything |
Assignee | assigned_to, assignee, owner |
Assignee Last Login Date | assignee_last_login |
Attachment description | attachmentdesc, attachdesc, attachment |
Attachment mime type | attachmentmimetype, attachmimetype |
Blocks | blocked |
Bug Interest | bug_interest_ts |
CC | cc |
Classification | classification |
Closed | cf_last_resolved |
Comment | description, longdesc, comment |
Comment Tag | comment_tag |
Commenter | commenter |
Component | component |
Content | content |
Days since issue changed | days_elapsed |
Deadline | deadline |
Depends on | dependson |
Duplicates | duplicates |
Ever confirmed | everconfirmed |
Filed via | filed_via |
Flag Requestee | requestee |
Flag Setter | setter |
Flags | flag |
Group | group |
Hardware | platform |
Hours Left | remaining_time |
Hours Worked | work_time |
Issue ID | bug_id |
Keywords | keywords, kw |
Last Visit | last_visit_ts |
Number of CC | cc_count |
Number of Duplicates | dupe_count |
Opened | creation_ts |
Orig. Est. | estimated_time |
OS | op_sys, os |
Priority | priority |
Product | product |
QA Contact | qa_contact |
Regressed by | regressed_by |
Regressions | regressions, regresses |
Reporter | reporter |
Resolution | resolution |
Restrict Comments | restrict_comments |
See Also | see_also |
Severity | severity |
Status | status |
Summary | short_desc, summary |
Tags | tag |
Target Milestone | target_milestone, milestone |
Time Since Assignee Touched | owner_idle_time |
Triage Owner | triage_owner |
Type | type |
Updated | delta_ts |
URL | url |
Version | version |
Votes | votes |
Whiteboard | whiteboard, sw |
Advanced Features
- If you want to search for a phrase or something that contains spaces, commas, colons or quotes, you must put it in quotes, like: "yes, this is a phrase". You must also use quotes to search for characters that would otherwise be interpreted specially by quicksearch. For example, "this|that" would search for the literal string this|that and would not be parsed as "this OR that". Also, "-field:value" would search for the literal phrase -field:value and would not be parsed as "NOT field:value".
- You can use AND, NOT,
and OR in searches.
You can also use - to mean "NOT", and | to mean "OR".
There is no special character for "AND", because by default any search
terms that are separated by a space are joined by an "AND".
Examples:
-
NOT:
Use -summary:foo to exclude issues with foo in the summary.
NOT summary:foo would have the same effect. -
AND:
foo bar searches for issues that contains both foo and bar.
foo AND bar would have the same effect. -
OR:
foo|bar would search for issues that contain foo OR bar.
foo OR bar would have the same effect.
You cannot use | nor OR to enumerate possible values for a given field. You must use commas instead. So field:value1,value2 does what you expect, but field:value1|value2 would be treated as field:value1 OR value2, which means value2 is not bound to the given field.
OR has higher precedence than AND; AND is the top level operation. For example:
Searching for url|location bar|field -focus means (url OR location) AND (bar OR field) AND (NOT focus)
-
NOT:
-
The default operator, colon (:), performs a substring
match of the value. The following operators are supported:
-
: (substring):
summary:foo will search for issues where the summary contains foo. -
= (equals):
summary=foo will search for issues where the summary is exactly foo. -
!= (notequals):
summary!=foo will search for issues where the summary is not foo. -
> (greaterthan):
creation_ts>-2w will search for issues where that were created between two weeks ago and now, excluding issues exactly two weeks old. -
>= (greaterthaneq):
creation_ts>=-2w will search for issues where that were created between two weeks ago and now, including issues exactly two weeks old. -
< (lessthan):
creation_ts<-2w will search for issues where that were created more than two weeks ago, excluding issues exactly two weeks old. -
<= (lessthaneq):
creation_ts<=-2w will search for issues where that were created more than two weeks ago, including issues exactly two weeks old.
-
: (substring):
Advanced Shortcuts
In addition to using field names to search specific fields, there are certain characters or words that you can use as a "shortcut" for searching certain fields:
Field | Shortcut(s) |
---|---|
Status | Make the first word of your search the name of any status, or even an abbreviation of any status, and issues in that status will be searched. ALL is a special shortcut that means "all statuses". OPEN is a special shortcut that means "all open statuses". Adding a '+' to the end of a status name will set the result limit to 0. |
Resolution | Make the first word of your search the name of any resolution, or even an abbreviation of any resolution, and issues with that resolution will be searched. For example, making FIX the first word of your search will find all issues with a resolution of FIXED. Adding a '+' to the end of a resolution name will set the result limit to 0. |
Priority | "P1" (as a word anywhere in
the search) means "find issues with the highest priority.
"P2" means the second-highest priority, and so on.
Searching for "P1-3" will find issues in any of the three highest priorities, and so on. |
Assignee | @value |
Product or Component | :value |
Flags | flag?requestee |
Comment or Summary | #value |
Comment Searching |
Allows overriding of the comment searching preference. "++comments" enables full-text search (all comments, slow) "--comments" disables full-text search "++description" enables description search (initial comment only) "--description" disables description search |
Examples of Complex Queries
It is pretty easy to write rather complex queries without too much effort. For very complex queries, you have to use the Advanced Search form.
- All issues reported by userA@company.com or assigned to them
(the initial @ is a shortcut for the assignee, see the
Advanced Shortcuts section above):
ALL @userA@company.com OR reporter:userA@company.com - All open issues in product productA with either severity
blocker, critical or major, or with priority P1, or with the blocker+
flag set, and which are neither assigned to userB@company.com nor to
userC@company.com (we make the assumption that there are only two users
matching userB and userC, else we would write the whole login name):
:productA sev:blocker,critical,major OR pri:P1 OR flag:blocker+ -assign:userB,userC - All FIXED issues with the blocker+ flag set, but without
the approval+ nor approval? flags set:
FIXED flag:blocker+ -flag:approval+ -flag:approval? - Issues with That's a "unusual" issue in the
issue summary (double quotes are escaped using \"):
summary:"That's a \"unusual\" issue"