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)

anyone() · Anyone

This function includes results which have any owner. It excludes unassigned or unowned results.

members(project) · Members: ...

This function allows you to find results for any of the members of a project:

members(frontend)

none() · No Owner

This function includes results which have no owner. Use a query like this to find unassigned results:

none()

If you combine this function with other functions, the query will return results which match the other selectors or have no owner. For example, this query will find results which are owned by alincoln, and will also find results which have no owner:

alincoln, none()

viewer() · Current Viewer

This function allows you to change the behavior of a query based on who is running it. When you use this function, you will be the current viewer, so it works like you typed your own username.

However, if you save a query using this function and send it to someone else, it will work like their username was the one that was typed. This can be useful for building dashboard panels that always show relevant information to the user who is looking at them.