All Categories Working with Tickets Advanced Ticket Search

Advanced Ticket Search

How to filter tickets

By Stefan Dreßler
May 20, 2021

By default, we search your term in the ticket subject, body, tags, and contact. But often it's important to add very specific filters. Below you find all advanced filters and some examples.

Ticket-Search.png

Note: A filter is applied to the current section. The easiest way is to search in the Inbox All. Only if you search for a specific ticket number like #54 will we search all sections.

Available Filters

Filter

Example

Description

#

#54

Find the ticket with the id 54.

subject:

subject:bug
subject:”can't open”

Searches the subject of a ticket.

body:

body:important
body:”important note”

Searches the message body.

subjectOrBody:

subjectOrBody:”some term”

Searches your term in subject OR body of the ticket.

contact:

contact:mike
contact:”Mike Smith”
contact:mike@smith.com

contact:@examplde.com

Searches name and email of the ticket contact.

tag:

tag:bug
tag:”feature request”

Searches the tag name of

agent:

agent:mike
agent:”mike smith”
agent:hello@smith.com

Searches the name and email of the assigned agent, and finds all tickets of this agent.

team:

team:sales

team:”quality management”

status:

status:waiting

Searches all tickets with that status waiting. Available status are open, waiting, escalated, closed, spam

Filter combinations

You can combine different filters. Here is what you need to know:

  • If the filters are different, HelpSpace automatically links them with an AND operator. All criteria must be met within a ticket for it to match the search:

    • Example: tag:bug body:”help me” contact:”Mike Smith”

  • If the same filter is applied multiple times, HelpSpace automatically links them with an OR operator. Only one criterion needs to be met within a ticket for it to match the search:

    • Example: tag:bug tag:sales

Search and Filter Tickets via URL

You can search or filter tickets in HelpSpace directly using the URL. This is useful if you want to:

  • Save filters as bookmarks for quick access.

  • Generate URLs from other tools, e.g., to search for specific tags or contacts.

URL Structure

Append ?search=your-term to the end of the ticket URL.

Example:

https://your-workspace.helpspace.com/#/tickets/all/631?search=your-term

Filter Examples

  • Filter by tag:

    ?search=tag:marketing
  • Filter by tag and agent:

    ?search=tag:marketing agent:"Jo Doe"

Full example URL:

https://your-workspace.helpspace.com/#/tickets/all/631?search=tag:marketing agent:"Jo Doe"

URL Encoding

Certain characters must be URL-encoded. While browsers usually handle this automatically, here are the encodings if you need to apply them manually:

Character

Encode as

:

%3A

(space)

%20


Full example with URL encoding:

https://dein-workspace.helpspace.com/#/tickets/all/631?search=tag%3Amarketing%20agent%3A"Jo%20Doe"

Important: Refresh Required

When testing or editing the URL manually in the browser, you must reload the page for the search to take effect. Simply changing the URL without refreshing won't trigger the filter.

Was this article helpful?

Thanks for your feedback!