2017-01-09 23:03:11 +01:00
|
|
|
# Searching for messages
|
|
|
|
|
|
2018-09-29 21:37:45 +02:00
|
|
|
Zulip has a powerful search engine under its hood. Search for messages using
|
|
|
|
|
the search bar at the top of the screen.
|
|
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
|
|
* `stream:design has:link is:starred new logo`
|
|
|
|
|
|
|
|
|
|
Searches for messages in `#design` that have a link, that you starred, and
|
|
|
|
|
that have the words `new` and `logo`.
|
|
|
|
|
|
|
|
|
|
The permalink for that search (web only) will look something like
|
|
|
|
|
`https://your-zulip-url/#narrow/stream/123-design/has/link/is/starred/search/new.20logo`.
|
|
|
|
|
|
|
|
|
|
## List of operators
|
|
|
|
|
|
|
|
|
|
As you start typing, Zulip will suggest possible operator completions.
|
|
|
|
|
Operators can be used with keywords, or on their own. For example,
|
|
|
|
|
|
|
|
|
|
* `stream:design logo` will search for the word `logo` within `#design`
|
|
|
|
|
* `stream:design` will navigate to `#design`
|
|
|
|
|
|
|
|
|
|
Here is the **full list of search operators**.
|
|
|
|
|
|
|
|
|
|
* `stream:design`: Search within the stream `#design`.
|
|
|
|
|
* `stream:design topic:emoji+picker`: Search within the topic `emoji picker`.
|
|
|
|
|
* `is:private`: Search all your private messages.
|
|
|
|
|
* `pm-with:ada@zulip.com`: Search 1-on-1 messages with Ada.
|
|
|
|
|
* `group-pm-with:ada@zulip.com`: Search group private messages that
|
|
|
|
|
include Ada.
|
|
|
|
|
* `sender:ada@zulip.com`: Search messages sent by Ada.
|
|
|
|
|
* `sender:me`: Search sent messages.
|
|
|
|
|
* `near:12345`: Show messages around the message with ID `12345`.
|
|
|
|
|
* `id:12345`: Show only message `12345`.
|
|
|
|
|
|
|
|
|
|
* `is:alerted`: See [alert words](/help/add-an-alert-word).
|
2019-02-28 20:42:48 +01:00
|
|
|
* `is:mentioned`: See [mentions](/help/mention-a-user-or-group).
|
2018-09-29 21:37:45 +02:00
|
|
|
* `is:starred`: See [starred messages](/help/star-a-message).
|
|
|
|
|
* `is:unread`
|
|
|
|
|
* `has:link`
|
|
|
|
|
* `has:image`
|
|
|
|
|
* `has:attachment`
|
|
|
|
|
|
|
|
|
|
## Words and phrases
|
|
|
|
|
|
|
|
|
|
Most searches consist of a list of operators followed by a list of keywords.
|
|
|
|
|
|
|
|
|
|
* `new logo`: Search for messages with both `new` and `logo`.
|
|
|
|
|
* `"new logo"`: Search for messages with the phrase `"new logo"`.
|
|
|
|
|
|
|
|
|
|
Zulip does some basic stemming, so `wave` will match `waves` and
|
|
|
|
|
`waving`. Keywords are case-insensitive, so `wave` will also match `Wave`.
|
|
|
|
|
|
|
|
|
|
Emoji are included in searches, so if you search for `octopus` it will
|
|
|
|
|
include messages with
|
|
|
|
|
<img src="/static/generated/emoji/images-google-64/1f419.png" alt="octopus"
|
|
|
|
|
class="emoji-small"/>.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Note that Zulip ignores common words like `a`, `the`, and about 100
|
|
|
|
|
others. A quirk in Zulip's current implementation means that if all of your
|
|
|
|
|
keywords are ignored, we'll return 0 search results.
|
|
|
|
|
|
2019-08-22 08:50:27 +02:00
|
|
|
## Messages sent before you joined
|
2018-09-29 21:37:45 +02:00
|
|
|
|
2019-08-22 08:50:27 +02:00
|
|
|
In most cases, Zulip only searches messages that you received. In particular,
|
|
|
|
|
this means Zulip will not search messages sent before you joined.
|
2018-09-29 21:37:45 +02:00
|
|
|
|
2019-08-22 08:50:27 +02:00
|
|
|
However, if a) the search includes a `stream:` operator and b) that stream
|
|
|
|
|
is either public or [private with shared history](/help/stream-permissions),
|
|
|
|
|
Zulip will search the entire history of the stream, including messages
|
|
|
|
|
that were sent before you joined.
|
