Typeahead Function Help

Overview

Typeahead functions are an advanced feature which allow you to build more powerful queries. This document explains functions available for the selected control.

For general help with search, see the Search User Guide in the documentation.

Note that different controls support different functions (depending on what the control is doing), so these specific functions may not work everywhere. You can always check the help for a control to review which functions are available for that control.

Function Quick Reference

This table briefly describes available functions for this control. For details on a particular function, see the corresponding section below.

Using Typeahead Functions

In addition to typing user and project names to build queries, you can also type the names of special functions which give you more options and the ability to express more complex queries.

Functions have an internal name (like viewer()) and a human-readable name, like Current Viewer. In general, you can type either one to select the function. You can also click the button on any typeahead control to browse available functions and find this documentation.

This documentation uses the internal names to make it clear where tokens begin and end. Specifically, you will find queries written out like this in the documentation:

viewer(), alincoln

When this query is actually shown in the control, it will look more like this:

Current Viewer alincoln (Abraham Lincoln)

any(project) · In Any: ...

This function allows you to find results in one of several projects. Another way to think of this function is that it allows you to perform an "or" query.

By default, if you enter several projects, results are returned only if they belong to all of the projects you enter. That is, this query will only return results in both projects:

ios, android

If you want to find results in any of several projects, you can use the any() function. For example, you can use this query to find results which are in either project:

any(ios), any(android)

You can combine the any() function with normal project tokens to refine results. For example, use this query to find bugs in either iOS or Android:

bug, any(ios), any(android)

not(project) · Not In: ...

This function allows you to find results which are not in one or more projects. For example, use this query to find results which are not associated with a specific project:

not(vanilla)

You can exclude multiple projects. This will cause the query to return only results which are not in any of the excluded projects:

not(vanilla), not(chocolate)

You can combine this function with other functions to refine results. For example, use this query to find iOS results which are not bugs:

ios, not(bug)

null() · Not Tagged With Any Projects

This function matches results which are not tagged with any projects. It is usually most often used to find objects which might have slipped through the cracks and not been organized properly.

null()

only() · Only Match Other Constraints

This function is used with other tags, and causes the query to match only results with exactly those tags. For example, to find tasks tagged only iOS:

ios, only()

This will omit results with any other project tag.

projects(username) · Projects: ...

This function allows you to find results associated with any of the projects a specified user is a member of. For example, this will find results associated with all of the projects alincoln is a member of:

projects(alincoln)

viewerprojects() · Current Viewer's Projects

This function matches results in any of the current viewing user's projects:

viewerprojects()

This normally means your projects, but if you save a query using this function and send it to someone else, it will mean their projects when they run it (they become the current viewer). This can be useful for building dashboard panels.