Search Syntax#

For most searches, one or two words are enough. With search expressions you can be more precise: search for an exact phrase, restrict the search to one attribute, or exclude words.

Note

This page explains how to write search expressions. To learn how the search menu below the search field works, including the recently accessed items and the filters, see Search.

You can use search expressions in the search field in the header and in the search tabs. They follow the same rules as the Allegra Query Language. This page summarizes what you need most often. For all details, see The Allegra Query Language (AQL).

How Words Are Matched#

Allegra is tolerant when it matches your words, so you do not need to type them exactly:

  • Upper and lower case do not matter.

  • A word of four or more characters also finds words that begin with it. For example, plan finds “planning”.

  • Longer words are also found if they contain a typing error. One wrong character is tolerated in words of six or more characters, two in words of twelve or more.

  • Numbers are always matched exactly.

If you enter several words, Allegra finds everything that contains at least one of them. Objects that contain all of the words rank higher.

Note

The system administrator can configure the search so that all words must be contained.

Search Expressions#

To find

Enter

Example

An exact phrase

Quotation marks

"release plan"

All of the words

AND or +

budget AND approval

At least one of the words

OR or a space

invoice OR receipt

Results without a word

NOT or -

server -test

Words in one attribute only

Attribute name and colon

Title:migration

Any single character

?

te?t finds “test” and “text”

Any number of characters

*

*port finds “import” and “export”

Similar words

~ after the word

meier~ also finds “meyer”

Words close to each other

~ and a number after a phrase

"server error"~5

A range of values

[... TO ...]

Changed:[20260101 TO 20261231]

Note the following rules:

  • Write the operators AND, OR and NOT in capital letters.

  • Use brackets to group expressions, for example (invoice OR receipt) AND 2026.

  • If you mark a word with *, ~ or quotation marks, it is searched exactly as you typed it, without the automatic tolerance.

Examples#

The following examples show typical searches. You can type them into the search field exactly as shown.

You want to find

Enter

What you get

Everything about invoices

invoice

Everything that contains “invoice”, and also “invoices” or “invoicing”

Something you only remember the beginning of

migr*

“migration”, “migrate”, “migrated” and so on

An exact wording

"content migration"

Only texts in which these two words follow each other

Texts that contain two words

login AND password

Only results that contain both “login” and “password”

Texts that contain one word or another

invoice OR receipt

Results that contain “invoice”, “receipt” or both

A topic without the test items

migration -test

Results that contain “migration” but not “test”

A word in the title only

Title:login

Items with “login” in the title. Matches in descriptions or comments are ignored.

Bugs about a topic

"Item type":Bug AND login

Items of the type “Bug” that contain “login”

A name you are not sure how to spell

Meier~

“Meier”, but also “Meyer” and “Maier”

A word in an attached file

Attachment:contract

Items with an attachment that contains “contract” in its name or content

Several conditions at once

Title:login AND (error OR fails)

Items with “login” in the title that also contain “error” or “fails”

An item whose number you know

itemId:1234

Exactly the item with the number 1234

Searching in an Attribute#

To restrict a word to one attribute, put the attribute name and a colon in front of it. You can use the name as it appears in your language. Upper and lower case do not matter. If the name contains a space, put it in quotation marks:

"Item type":Bug

The attribute name applies only to the word or phrase that directly follows it. In Title:data migration only “data” is searched in the title. Use Title:"data migration" or Title:data AND Title:migration instead.

To search in the data linked to an item, use these names:

Name

Searches in

Attachment:

Names, descriptions and content of attachments

Link:

Comments of links to other items

Expense:

Expenses booked on the item

Budget:, Plan:

Descriptions of budgets and planned values

Watcher:

Consulted and informed persons

Finding an Item by Its Number#

If you know the number of an item, you can open it without searching for its text:

  • itemId:1234 finds exactly the item with the number 1234. Enter nothing else in the search field. This number is the system-wide item number. You can search for it even if your system uses workspace-specific item numbers.

  • If your system uses workspace-specific item numbers, enter the number with its prefix, for example ABC-12.

A number without itemId: is searched in all attributes. It finds the item with this number, but also items that contain the number in their title or description.

If a Search Expression Is Not Accepted#

The search menu shows no results while an expression is incomplete, for example while a quotation mark is still open. The search tabs show a message instead:

Message

What to do

The search text cannot be read as a search expression.

Check that every quotation mark and bracket is closed and that AND, OR and NOT stand between two words.

The search text expands to too many terms.

Use longer or more specific words, especially together with *.