Skip to main content

Search and filters

How to find a conversation or a specific message.

Press / from anywhere in the workspace to focus the global search bar. Conversations and messages are indexed and surface in results alongside other entities (people, files, etc.).

  • Type a person's name to find DMs with them.
  • Type a phrase in quotes to search for an exact match across messages: "deployment fix".
  • Type a channel name to jump straight to the channel.

Behind the scenes, message search is backed by PostgreSQL full-text search (a tsvector column with English text-search rules) plus a LIKE fallback for very short queries. Results are ranked by relevance.

Search within a conversation​

Open any conversation → header → Search icon (magnifying glass).

  • Searches messages within just this conversation.
  • Same ranking as global search.
  • Use cursor pagination to scroll through more results — older results load as you scroll.

Search messages across all your conversations​

/conversations/list has a search bar at the top. Filtering by message text searches across every conversation you are a member of.

Tabs and filters on the landing page​

/conversations provides quick filters as tabs:

  • All conversations — every conversation you are in (default).
  • Channels — only channels.
  • Direct messages — only DMs.
  • Groups — only group chats.
  • Archived — conversations you or an admin archived.

The list is paginated using cursor pagination — scrolling reveals older entries. There is no "page N of M" — the system always knows whether more remain (pageInfo.hasNextPage).

Sort options​

By default, conversations sort by last activity (newest first). The list view (/conversations/list) lets you switch:

  • Activity — newest message first.
  • Created — newest conversation first.
  • Alphabetical — by title.

Filtering​

In /conversations/list, the filter chip row offers:

  • Has unread — only conversations with unread messages.
  • Pinned — only pinned conversations.
  • Type — DM / Group / Channel multi-select.
  • Tags — assigned tags (when the tags integration is active).

Filter changes are persisted to the URL so your view is shareable.

Mentions inbox​

Open the @ icon in the workspace header to see your mentions inbox. It aggregates @you mentions from every conversation, ordered newest first, with a one-click jump to the original message in context.

You can mark items read from the inbox without opening the conversation.

Performance notes​

  • The list view uses cursor pagination with a default page size of 20. Scrolling fetches the next page when you near the end.
  • Initial page-load makes at most one workspace and one global GraphQL request (the rest is loaded on demand).
  • Search results stream as you type after a 200ms debounce.

Next steps​