Queries
What are Queries?
Queries let you automatically gather and display content based on defined rules. You can filter by properties, tags, content, or object types. Results update automatically whenever new content matches the defined criteria.
For example, to view all the books you completed in 2025, you could create a query for the Book object type and filter by the Completed On property, set to dates within 2025. When you mark a new book as completed in 2025, it will automatically appear in that query.
Think of queries as saved filters or smart views. Queries are objects too, so you can link or embed them like any other object.
You can use them to:
- Find and reuse specific information (e.g. all meetings with Jane)
- Embed filtered content in other objects (e.g. topics from this semester in class notes)
- Build dashboards or contextual views (e.g. a project page with just its meetings)
You can also see them as automated, dynamic collections. Instead of manually curating a list, a query does it for you. It updates in real time as your content grows, as long as the content fits the rules you've defined.
Query types
Queries extend the functions you're already used to using.
There are three different types of queries:
- Object type queries Object type queries return content based on a set of object types and optional filters. You can apply rules based on collections, tags, and properties. Object type queries extend your object dashboards.
- Search queries Search queries return content based on a set of search terms. You can apply rules based on object types, properties, or tags to narrow down your results. Search queries extend the extended search.
- Tag queries Tag queries return content that is tagged by a set of tags. You can apply rules based on object types, properties, or other tags to narrow down your results. Tag queries extend tag pages.
If you want to get a quick overview of queries, check out this video:
Because search queries and extended search are so related, you can simply open the extended search by pressing Cmd + Shift + P (Mac) or Ctrl + Shift + P(Windows), define your search parameters, and click 'save as query' when you're done.
If you want to learn more about how to use search queries, check out this video: