Search Tasks

The search functionality in GQueues allows you to find tasks no matter where they are stored.


NOTE: A paid subscription is required to use the search feature, or you can start a 2-week free trial.

Simple Search

To search for a task type your search term in the box and press enter or click the search button.

With a simple search GQueues searches all fields of all your tasks to find any matches.

Double-click the colored box on any task in the results to be taken to the Task Overview where you can add subtasks and modify all properties of the task.


Typing the forward slash key ( / ) will place your cursor in the search box to make searching even faster.

NOTE: When creating tasks or updating existing ones it can take up to 30 seconds before they show up in search results.

Advanced Search

Click the grey arrow in the search box to bring up the advanced search form.

Here you can specify the categories, queues and exact fields you want to search.


Partial Word Search

An asterisk (*) can be used to perform a partial-word search. For instance, searching for water* will return both "water" and "watermelon" in search results.

In general, the asterisk serves as a wildcard character and can be used anywhere in your search phrase. For instance, searching for l*nch will return both "lunch" and "launch" in search results.


Fuzzy Search

A tilde (~) can be used to perform a fuzzy search - meaning it will look for exact matches and matches with a difference of one character somewhere in the word. For instance, searching for review~ will return both "review" and the misspelled "reveiw" in search results. The tilde must be placed at the end of the search term.


Query Language

The following language can be used to create more powerful search queries.

Fields

To search a specific field in a task type the name of the field, followed by a colon and the search value in parentheses.

For instance, to search for tasks with the tags today and calls you would type tag:(today AND calls) in the search box.

The following fields can be used in search queries (the field names are case-sensitive):

Search Field Format Example
title: text title: review
notes: text notes: blog post
tag: text tag: urgent
attachment: text attachment: Q2_graph.png
assignedTo: text assignedTo: shannon@mycompany.com
dateCreated: yyyy-mm-dd dateCreated: >2020-01-01
dateCompleted: yyyy-mm-dd dateCompleted: >=[-7 days]
lastModified: yyyy-mm-dd lastModified: >[-1 days]
dueDate: yyyy-mm-dd dueDate: <[+14 days]
dueTime: "HH:MM" must be in quotes, can be 12- or 24-hour format dueTime: "08:15 pm"
duration: number of minutes duration: 120
crossedOut: true or false crossedOut: true
repeats: true or false repeats: true
hasDueDate: true or false hasDueDate: false
hasDueTime: true or false hasDueTime: true
hasReminder: true or false hasReminder: false
hasNotes: true or false hasNotes: true
isSubtask: true or false isSubtask: false
numTags: number numTags: >0
numAttachments: number numAttachments: 0
numAssignments: number numAssignments: 1
numComments: number numComments: 0
numSubtasks: number numSubtasks: >0
numOpenSubtasks: number numOpenSubtasks: >3
numArchivedSubtasks: number numArchivedSubtasks: >0


Special Characters

The following are considered special characters in search, because they are used in the search syntax itself:

* ! : & | ( ) { } [ ] - + ^ " ~ /

If you wish to use one of these characters in your search term, you must either put the term in quotes or escape the character by putting a backslash (\) before it.

For example, if you have a tag urgent! and want to search for tasks with this tag you would search for tag:urgent\!

Alternatively, you could also search for tag:"urgent!"



Operators

Search operators can be used to create more complex queries.

For instance, if you want tasks that are tagged today OR urgent and not tagged home you would write
tag:((today OR urgent) AND NOT home) in the search box.

The following boolean operators can be used in search queries:

  • AND
  • OR
  • NOT

Parentheses are used for logical groupings and quotes can be used to search for exact phrases
(ie. description:"revise meeting minutes").

The following numeric operators can be used with the number fields and date fields in search queries:

  • >
  • >=
  • <
  • <=

No spaces are allowed between an inequality sign and the value following it.


Relative Dates

Instead of typing concrete dates in your search you can use relative dates which can be useful for saved searches.

To use a relative date type the number of days + or - from today in square brackets.

For instance, to create a search for all tasks that have been completed in the last 30 days type:
dateCompleted: >=[-30 days]

If you save this search as a smart queue, whenever you view the smart queue it will recalculate the dates based on the current day so you see tasks from the last 30 days.

To search for all tasks overdue or due in the next 2 weeks type dueDate: <[+14 days]

To see all tasks due today or tagged urgent type dueDate:[today] OR tag:urgent


Saved Searches

You can save searches as Smart Queues for easy retrieval of tasks.

From the Advanced Search window click on save search.

Here you can give the search a name and modify the query as necessary using the GQueues query language.

Saved searches appear in your smart queues with a different icon, but can be managed just like any other smart queue.

To edit a saved search click the menu and choose Edit....

When you click a saved search the first 25 tasks are loaded automatically.

To load the next batch of tasks you must click the Show more results.... button at the bottom.


Mobile Access for Saved Searches

A network connection is required to view Saved Searches in the GQueues Android and iOS apps. Only the first 100 tasks are shown.