Searching for content effectively

[Moin]

Since some filters are missing, like in:pinned or in:bookmarks and those which have an alias aren’t explained, I tried to add the missing information. Then the table became quite complex, which is why I tried to separate it into smaller tables. This is something the bot also did here. I’m not sure the explanations are all correct. The descriptions in the topic and the ones in @sam’s conversation with the bot differ. For some, I even asked the bot again and got another result (these are the highlighted ones). Perhaps someone can help to correct the descriptions. I am also not entirely happy with the overall appearance. The table columns all have different widths.

---

Filters

Search Filters

Syntax	Description
topic:topic_id	Returns posts in a specific topic
in:title t	Returns topics with the term in the title
in:first f	Returns only first posts in topics
in:replies	Returns only posts that are replies, excludes topic OPs
in:regular	Excludes small action posts, whispers, and posts with staff color applied
in:whispers in:whisper	For users with whisper access only Returns whisper posts
include:unlisted include:invisible	For Trust Level 4 and staff only Returns posts, including those from unlisted topics
in:all	For logged-in users only Returns posts from public topics and personal messages
in:all-posts	Returns every post that matches the query, even when multiple posts match within the same topic
in:pinned	Returns pinned posts
in:wiki	Returns wiki posts
with:images	Returns posts containing images
filetypes:ext1,ext2,ext3 filetype:ext1,ext2,ext3	Returns posts with uploads of ext1, ext2, or ext3 file extensions
badge:name_or_id	Returns posts linked to a specific badge grant

Message Filters

(for logged-in users)

Syntax	Description
in:personal in:messages	Returns posts from personal messages
in:personal-direct	Returns posts from personal messages between you and exactly one other user
group_messages:group_name_or_id	Returns posts from personal messages sent to the group_name group (This does only work when the group and it’s members are visible for you)
personal_messages:username	For Admins only Returns posts from personal messages of the specified user
in:all-pms	For Admins only Returns posts from all personal messages, including those you’re not a part of

User and Group Specific Filters

Syntax	Description
@username user:username_or_id	Returns posts by username
created:@username in:first @username	Returns first posts in topics created by username
group:group_name_or_id	Returns posts from users within the group_name group
in:bot in:bots	Returns posts from system and bot accounts (e.g., @system, @discobot)
in:human in:humans	Returns posts from regular users

Category and Tag Filters

Syntax	Description
category:category1 #category1	Returns posts from category1
categories:category1,category2 category:category1,category2	Returns posts from the categories category1 and category2
tag:tag1 #tag1	Returns posts from topics tagged with tag1
-tag:tag1	Returns posts from topics not tagged with tag1
tags:tag1,tag2 tag:tag1,tag2	Returns posts from topics tagged with tag1 or tag2
-tags:tag1,tag2 -tag:tag1,tag2	Returns posts from topics not tagged with tag1 or tag2
tags:tag1+tag2 tag:tag1+tag2	Returns posts from topics tagged with tag1 and tag2
-tags:tag1+tag2 -tag:tag1+tag2	Returns posts from topics not tagged with tag1 and tag2
in:tagged	Returns posts from topics that have at least one tag
in:untagged	Returns posts from topics with no tags

Personalized Filters (User-Specific)

(for logged-in users)

Syntax	Description
in:seen	Returns posts you’ve seen
in:unseen	Returns posts you haven’t seen
in:watching	Returns posts from topics you’re watching
in:tracking	Returns posts from topics you’re tracking
in:bookmarks	Returns posts you’ve bookmarked
@me @your_own_username	Returns posts written by you
in:posted	Returns all posts of topics you have posted in
in:created in:mine	Returns first posts of topics written by you

Post and View Count Filters

Syntax	Description
min_posts:X min_post_count:X	Returns posts from topics with at least X posts
max_posts:X	Returns posts from topics with at most X posts
posts_count:X	Returns posts from topics that have exactly X posts
min_views:X	Returns posts from topics with at least X views
max_views:X	Returns posts from topics with at most X views

Date Filters

All dates are in UTC, we always use beginning of day UTC as the start time for any period.

Syntax	Description
before:YYYY-MM-DD	Returns posts created before the specified date
after:YYYY-MM-DD	Returns posts created after the specified date
before:day_of_week	Returns posts created before the specified day of the week
after:day_of_week	Returns posts created on and after the specified day of the week
before:X	Returns posts created more than X days ago
after:X	Returns posts created within the last X days
before:month	Returns posts created before the specified month
after:month	Returns posts created within and after the specified month
before:YYYY	Returns posts created before the specified year
after:YYYY	Returns posts created within and after the specified year

Status Filters

Syntax	Description
status:open	Returns posts from topics that are not closed or archived
status:closed	Returns posts from closed topics
status:archived	Returns posts from archived topics
status:noreplies	Returns posts from topics with no replies
status:single_user	Returns posts from topics with posts from only one user
status:public	Returns posts from topics in public categories

Language filters

Syntax	Description
locale:language_code	Returns posts written in that language e.g. en, en_US, en-gb
locale:any locale:present	Returns posts that have a locale set
locale:none locale:null	Returns post without a locale

Filters added by Plugins

Syntax	Description
Assign
in:assigned	Returns posts from topics assigned to someone
in:unassigned	Returns posts from topics not assigned to anyone
assigned:username	Returns posts from topics assigned to username
Docs
in:docs in:kb	Returns posts from categories and tags included in docs
Doc Categories
in:docs	Returns posts from categories that have an index topic
Polls
in:polls	Returns posts containing polls
Solved
status:solved	Returns posts from solved topics
status:unsolved	Returns posts from unsolved topics in categories allowing solved marking
Topic voting
min_vote_count:X	Returns posts from topics with at least X votes

Order

Syntax	Description
order:latest l	Sorts results from newest to oldest
order:oldest	Sorts results from oldest to newest
order:latest_topic	Sorts results by topic date, from newest to oldest
order:oldest_topic	Sorts results by topic date, from oldest to newest
order:views	Sorts results by number of views
order:likes	Sorts results by number of likes
order:read r	For logged-in users only Sorts results by date you last visited the topic

Order options added by Plugins

Syntax	Description
Topic voting
order:votes	Sort results by number of votes on the topic containing the post