Skip to main content
Version: v0.21.0

Search Query Language

Hoarder provides a search query language to filter and find bookmarks. Here are all the supported qualifiers and how to use them:

Basic Syntax

  • Use spaces to separate multiple conditions (implicit AND)
  • Use and/or keywords for explicit boolean logic
  • Use parentheses () for grouping conditions
  • Prefix qualifiers with - to negate them

Qualifiers

Here's a comprehensive table of all supported qualifiers:

QualifierDescriptionExample Usage
is:favFavorited bookmarksis:fav
is:archivedArchived bookmarks-is:archived
is:taggedBookmarks that has one or more tagsis:tagged
is:inlistBookmarks that are in one or more listsis:inlist
url:<value>Match bookmarks with URL substringurl:example.com
#<tag>Match bookmarks with specific tag#important
Supports quoted strings for tags with spaces#"work in progress"
list:<name>Match bookmarks in specific listlist:reading
Supports quoted strings for list names with spaceslist:"to review"
after:<date>Bookmarks created on or after date (YYYY-MM-DD)after:2023-01-01
before:<date>Bookmarks created on orbefore date (YYYY-MM-DD)before:2023-12-31

Examples

# Find favorited bookmarks from 2023 that are tagged "important"
is:fav after:2023-01-01 before:2023-12-31 #important

# Find archived bookmarks that are either in "reading" list or tagged "work"
is:archived and (list:reading or #work)

# Find bookmarks that are not tagged or not in any list
-is:tagged or -is:inlist

Combining Conditions

You can combine multiple conditions using boolean logic:

# Find favorited bookmarks from 2023 that are tagged "important"
is:fav after:2023-01-01 before:2023-12-31 #important

# Find archived bookmarks that are either in "reading" list or tagged "work"
is:archived and (list:reading or #work)

# Find bookmarks that are not favorited and not archived
-is:fav -is:archived

Any text not part of a qualifier will be treated as a full-text search:

# Search for "machine learning" in bookmark content
machine learning

# Combine text search with qualifiers
machine learning is:fav