This cheatsheet describes how to search and tag posts.
Searching
{{blonde_hair blue_eyes}}
Search for posts that have both Blonde Hair and Blue Eyes.
{{blonde_hair or blue_eyes}}
Search for posts that have either Blonde Hair, or Blue Eyes, or both.
{{-blonde_hair -blue_eyes}}
Search for posts that don't have Blonde Hair or Blue Eyes.
{{-(blonde_hair blue_eyes)}}
Search for posts that don't have both of Blonde Hair and Blue Eyes (but may have either one or neither).
{{(blonde_hair blue_eyes) or (red_hair green_eyes)}}
Search for posts that have either both Blonde Hair and Blue Eyes or both Red Hair and Green Eyes.
{{~blonde_hair ~blue_eyes}}
Legacy disjunctive operator, equivalent to {{blonde_hair or blue_eyes}}.
{{shirt_*}}
{{*_shirt}}
{{*shirt*}}
Wildcard pattern search. The asterisk symbol ([code]*[/code]) means "anything can go here". This example will return tags that start with, end with, or contain the word [code]shirt[/code]. Note: This will only return up to the 100 largest tags matching your pattern.
Metatags
User qualifiers
Users
{{user:albert}}
Search for posts uploaded by the user albert.
{{-user:albert}}
Search for posts not uploaded by the user albert.
Favorites
{{fav:albert}}
Search for posts favorited by the user albert.
{{-fav:albert}}
Search for posts not favorited by the user albert.
{{ordfav:albert}}
Search for posts favorited by the user albert ordered in the order they were favorited in, instead of by the date they were uploaded.
{{favcount:>10}}
Search for posts with at least 10 favorites.
{{order:favcount}}
Order search results by most favorited to least favorited.
Approvers
{{approver:albert}}
Search for posts that were approved by the user albert.
{{-approver:albert}}
Search for posts that were not approved by the user albert.
{{approver:any}}
Search for posts that were approved by anybody (that is, posts that went through the mod queue).
{{approver:none}}
Search for posts that were approved by nobody (that is, posts that bypassed the mod queue).
Comments
{{commenter:albert}} or {{comm:albert}}
Search for posts that were commented on by the user albert.
{{commenter:any}} or {{comm:any}}
Search for posts that have comments.
{{commenter:none}} or {{comm:none}}
Search for posts that don't have comments.
{{comment:blah}}
Search for posts with comments saying "blah".
{{order:comment}} or {{order:comm}}
Order search results by most recently commented on. Includes non-bumping comments.
{{order:comment_bumped}}
Order search results by most recently bumped.
Notes
{{noter:albert}}
Search for posts that have had notes created by the user albert.
{{noter:any}}
Search for posts that have notes.
{{noter:none}}
Search for posts that don't have notes.
Note that the noter: metatag includes deleted notes. If you want to search for active notes, use {{has:notes}} (and inversely, {{noter:any -has:notes}} will search for posts with only deleted notes).
{{noteupdater:albert}}
Search for posts that have had notes updated by the user albert.
{{note:blah}}
Search for posts with notes saying "blah".
{{order:note}}
Order search results by most recently updated notes.
Flags
{{status:flagged}}
Search for posts that are currently flagged.
{{flagger:albert}}
Search for posts that have ever been flagged by albert (mod only; normal users may only search for flags created by themselves).
{{flagger:any}}
Search for posts that have ever been flagged.
{{flagger:none}}
Search for posts that have never been flagged.
Appeals
{{appealer:albert}}
Search for posts that have even been appealed by albert.
{{appealer:any}}
Search for posts that have ever been appealed.
{{appealer:none}}
Search for posts that have never been appealed.
Artist commentaries
{{commentary:true}}
Search for posts that have artist commentaries.
{{commentary:false}}
Search for posts that don't have artist commentaries.
{{commentary:translated}}
Search for posts that have translated artist commentaries.
{{commentary:untranslated}}
Search for posts that don't have translated artist commentaries.
{{commentary:"blah blah"}}
Search for posts that have artist commentaries containing "blah blah".
{{commentaryupdater:albert}}
Search for posts that have had artist commentaries created by the user albert.
{{order:artcomm}}
Order search results by most recently updated commentaries.
Favorite groups
{{favgroup:cute}}
Search for posts in the favgroup "cute" (see Help:Favorite Groups).
{{-favgroup:cute}}
Search for posts not in the favgroup "cute".
{{ordfavgroup:blah}}
Search for posts in favgroup "blah", in the same order they were added to the favgroup.
Saved searches
{{search:artists}}
Search for posts in the saved search named "artists" (see /saved_searches).
Range qualifiers
ID number
{{id:1000}}
Search for posts with an ID number of 1000.
{{id:1000..}} or {{id:>=1000}}
Search for posts with an ID number of 1000 or greater.
{{id:>1000}}
Search for posts with an ID number greater than 1000.
{{id:..1000}} or {{id:<=1000}}
Search for posts with an ID number of 1000 or less.
{{id:<1000}}
Search for posts with an ID number less than 1000.
{{id:1000..2000}}
Search for posts with an ID number between 1000 and 2000.
{{id:1000...2000}}
Search for posts with an ID number between 1000 and 1999, not including 2000.
{{id:1000,2000,3000}}
Search for posts having IDs of 1000, 2000, or 3000. Commas may be used to specify a list of IDs.
{{order:id}} or {{order:id_asc}}
Order search results in ascending order based on post ID.
{{order:id_desc}}
Order search results in descending order based on post ID.
{{id:3000,1000,2000 order:custom}}
Search for IDs in a custom order. Can only be used with comma-separated IDs like the above.
Date
{{date:2007-01-01}}
Search for posts uploaded on a certain date (uses same syntax as id search - later dates are considered greater).
Age
{{age:2weeks..1year}} or {{age:2w..1y}}
Search for posts uploaded between 2 weeks and 1 year ago. Available parameters: seconds (s), minutes (mi), hours (h), days (d), weeks (w), months (mo), years (y). Any abbreviation of the parameters is possible as long as they stay unambiguous: sec, min, mont…
Post qualifiers
Status
{{status:any}} or {{status:all}}
Show all posts, even deleted posts.
{{status:deleted}}
Search for posts that are currently deleted.
{{-status:deleted}}
Search for posts that are not currently deleted.
{{status:pending}}
Search for posts that are currently pending (posts uploaded in the last three days and not yet approved).
{{status:flagged}}
Search for posts that are currently flagged. Use {{flagger:any}} to find posts that have ever been flagged.
{{status:appealed}}
Search for posts that have a pending appeal. Use {{appealer:any}} to find posts that have ever been appealed.
{{status:modqueue}}
Search for all posts currently in the mod queue. Equivalent to {{status:pending or status:flagged or status:appealed}}.
{{status:unmoderated}}
Search for posts that are currently pending and that the searcher has not made a judgement on. Only available to approvers.
{{status:banned}}
Search for posts that are currently banned. Works in combination with other status searches. Only available to site staff.
Ratings
{{rating:explicit}} or {{rating:e}}
Search for posts that are rated explicit.
{{rating:questionable}} or {{rating:q}}
Search for posts that are rated questionable.
{{rating:sensitive}} or {{rating:s}}
Search for posts that are rated sensitive.
{{rating:general}} or {{rating:g}}
Search for posts that are rating general.
{{-rating:sensitive}} or {{-rating:s}}
Search for posts that are not rated sensitive.
{{rating:q,s}}
Search for posts that are rated either questionable or sensitive.
Source
{{source:none}}
Search for posts with no source specified.
{{-source:none}}
Search for posts with any source.
{{source:http}}
Seach for posts with URL links as a source.
{{-source:http}}
Seach for posts with no URL links as a source. Also includes empty sources.
Search for posts with a source that starts with https://twitter.com.
Search for posts that do not have a source starting with https://twitter.com.
For pixiv sources, you can instead use {{pixiv:1234}} (replacing 1234 with the pixiv artwork ID) which should be faster.
{{source:*touhou*}}
Search for posts with a source containing the string "touhou". '*' is a wildcard.
{{source:"*Kantai Collection*"}}
Search for posts with a source containing the string "Kantai Collection". Quotes may be used to search for sources containing spaces.
Pixiv ID
{{pixiv:8314}}
Search for posts sourced from pixiv #8314. This supports numeric range syntax: {{pixiv:<1000}}, {{pixiv:1000..2000}}.
{{pixiv:any}}
Search for any posts sourced from pixiv.
Parent/child
{{parent:1}}
Search for posts that have post #1 as a parent (including post #1).
{{parent:none}}
Search for posts that have no parent (that is, exclude child posts).
{{parent:any}}
Search for posts that have a parent (that is, include only child posts).
{{child:none}}
Search for posts that have no children.
{{child:any}}
Search for posts that have at least one child.
Tag counts
{{tagcount:2}}
Search for posts with two tags (uses same syntax as id search).
{{gentags:2}}
Search for posts with two general tags (uses same syntax as id search).
{{arttags:2}}
Search for posts with two artist tags.
{{chartags:2}}
Search for posts with two character tags.
{{copytags:2}}
Search for posts with two copyright tags.
{{metatags:2}}
Search for posts with two meta tags.
Score
{{score:100}}
Search for posts with a score of 100 (uses same syntax as id search).
{{order:score}}
Order search results in descending order based on post score.
{{order:score_asc}}
Order search results in ascending order based on post score.
{{order:rank}}
Order search results in descending order based on score and recency of upload.
{{order:downvotes}}
Order search results in descending order based on number of downvotes.
{{order:upvotes}}
Order search results in descending order based on number of upvotes.
{{downvotes:>10}}
Search for posts that were downvoted more than 10 times.
{{upvotes:>10}}
Search for posts that were upvoted more than 10 times.
Disapproved
{{disapproved:disinterest}}
Search for posts that have been marked by an approver as disinterest.
{{disapproved:breaks_rules}}
Search for posts that have been marked by an approver as breaking the rules.
{{disapproved:poor_quality}}
Search for posts that have been marked by an approver as poor quality.
{{disapproved:your_name_here}}
Search for posts that you have disapproved (approvers only).
Post changes
{{order:change}}
Order posts by most recently updated.
Autotagger
{{ai:portrait}}
Search by suggested tags.
{{ai:portrait,>75%}}
Search by suggested tags using a confidence threshold.
Image qualifiers
MD5 hash
{{md5:d34e4cf0a437a5d65f8e82b7bcd02606}}
Search for posts with the MD5 hash d34e4cf0a437a5d65f8e82b7bcd02606.
{{order:md5}}
Order posts by MD5. Useful for ordering posts in a random (but fixed) order.
Dimensions
{{width:100}}
Search for posts with a width of 100 pixels (uses same syntax as id search).
{{height:100}}
Search for posts with a height of 100 pixels (uses same syntax as id search)
Ratio
{{ratio:4:3}} or {{ratio:4/3}}
Search for posts with a width:height ratio of 4:3 (uses same syntax as id search).
{{order:landscape}}
Order landscape images first.
{{order:portrait}}
Order portrait images first.
Megapixels
{{mpixels:2.5..}}
Search for posts with 2.5 million pixels or greater (uses same syntax as id search).
{{order:mpixels}}
Order search results in descending order based on resolution.
{{order:mpixels_asc}}
Order search results in ascending order based on resolution.
Filesize
{{filesize:200kb..1.5M}}
Search for posts with a filesize between 200 kilobytes and 1.5 megabytes (uses same syntax as id search).
{{order:filesize}}
Order search results in descending order based on file size.
Filetype
{{filetype:png}}
Search for posts with a filetype of PNG. Common filetypes: jpg, png, gif, swf, webm, mp4, zip (Ugoira).
File Properties
{{exif:"FFmpeg:VideoCodec=h264"}}
Search by EXIF metadata. Follows the format [code]category:tag name=value[/code].
Duration
{{duration:30}}
Search for animated posts that are 30 seconds long.
{{duration:<60}}
Search for animated posts that are not longer than 60 seconds.
{{duration:>10}}
Search for animated posts that are at least 10 seconds long.
is: and has:
{{is:parent}}, {{has:children}}
Search for posts that have a child post. Equivalent to {{child:any}}.
{{is:child}}, {{has:parent}}
Search for posts with a parent post. Equivalent to {{parent:any}}.
{{is:general}}, {{is:sensitive}}, {{is:questionable}}, {{is:explicit}}
Search for posts of a certain rating. Equivalent to {{rating:general}}, etc.
{{is:sfw}}, {{is:nsfw}}
Search for safe-for-work or not safe-for-work posts. Equivalent to {{rating:g,s}} and {{rating:q,e}}, respectively.
{{is:active}}, {{is:deleted}}, {{is:pending}}, {{is:unmoderated}}, {{is:modqueue}}, {{is:banned}}, {{is:appealed}}, {{is:flagged}}
Search for posts by their status. Equivalent to {{status:active}}, etc.
{{is:jpg}}, {{is:png}}, {{is:gif}}, {{is:mp4}}, {{is:webm}}, {{is:swf}}, {{is:zip}}
Search for posts by their file type. Equivalent to {{filetype:jpg}}, etc.
{{has:source}}
Search for posts with a source. Equivalent to {{source:*}}
{{has:appeals}}
Search for posts which have been appealed. Equivalent to {{appeals:>0}}
{{has:flags}}
Search for posts which have been flagged. Equivalent to {{flags:>0}}
{{has:replacements}}
Search for posts which have had their image replaced. Equivalent to {{replacements:>0}}
{{has:comments}}
Search for posts which have comments. Equivalent to {{comments:>0}}
{{has:commentary}}
Search for posts which have commentary. Equivalent to {{commentary:any}}
{{has:notes}}
Search for posts with notes. Equivalent to {{notes:>0}}
{{has:pools}}
Search for posts in a pool. Equivalent to {{pool:any}}
Pools
{{pool:4}}
Search for posts that are in pool #n4.
{{-pool:4}}
Search for posts that are not in pool #n4.
{{pool:none}}
Search for posts that are not in any pools.
{{pool:any}}
Search for posts that are in at least one pool.
{{pool:series}}
Search for posts that are in at least one series-category pool.
{{pool:collection}}
Search for posts that are in at least one collection-category pool.
{{-pool:series}}
Search for posts that are not in any series-category pools.
{{-pool:collection}}
Search for posts that are not in any collection-category pools.
{{pool:boo_boo_kagaboo}}
Search for posts in the pool with the name Boo Boo Kagaboo. Make sure to replace spaces with underscores.
{{ordpool:boo_boo_kagaboo}}
Search for posts in the pool with the name Boo Boo Kagaboo and display them in the order they appear in the pool, instead of the order they were uploaded.
Abbreviations
Abbreviations are automatically supported by typing a slash followed by the first character of every underscore-separated word in the tag name. Special characters such as parentheses are ignored when searching. Results are ordered based on post count; the tag with the most posts is at the top of the list and will be the one shown if searching for the abbreviation itself.
{{/bpa}}
Expands to Blue Poison (Arknights).
Other
{{upvote:username}}
Searches for posts upvoted by the user. Only Admins can see upvotes by users other than themselves.
{{downvote:username}}
Searches for posts downvoted by the user. Only Admins can see upvotes by users other than themselves.
{{order:none}}
Order search results in no particular order (not guaranteed to be completely random, but usually close to it). Internally, results are returned in whichever way the database retrieves them.
Generates up to N random results. May be less reliable than order:random, but significantly faster.
{{order:random}}
Generates a random number per result and sorts by that. More likely to timeout due to increased database load.
{{limit:5}}
Change the number of posts that appear on a single page to 5. Does not change the results themselves. The maximum limit is 200.
{{rating:questionable rating:sensitive}}
In general, combining the same metatags (the ones that have colons in them) will not work. Use {{rating:q,s}} instead.
{{rating:questionable score:100.. id:..1000}}
You can combine different metatags, however.
Tagging
Many of the above metatags can also be used when tagging posts. For example, tagging a post with {{rating:sensitive pool:Disgustingly_Adorable}} sets the rating to sensitive and adds the post to the Disgustingly Adorable pool.
These metatags can also be used in tag scripts.
blonde_hair blue_eyes
Tags a post with Blonde Hair and Blue Eyes. Use spaces to separate tags. Use underscores to separate words within tags.
-blonde_hair
Removes the Blonde Hair tag from the post.
tanaka_rie souryuu_asuka_langley
Use LastName FirstName order for characters with Japanese last names, or characters with full Chinese or Korean names. Middle names always follow the first name.
john_smith akira_ferrari tony_leung
Use FirstName LastName order for characters with non-Asian names, or characters with Japanese first names but non-Asian last names, or characters with non-Asian first names but Chinese last names.
general:food
Prefix a tag with general: (or gen:) to set it as a general tag.
artist:wakatsuki_sana
Prefix a tag with artist: (or art:) to set it as an artist tag.
character:gasai_yuno
Prefix a tag with character: (or char:) to set it as a character tag.
copyright:mirai_nikki
Prefix a tag with copyright: (or copy:) to set it as a copyright tag. Copyright tags include things like anime, manga, games, novels, or original doujinshi works.
rating:questionable (or rating:e, rating:q, rating:s, rating:g)
Rate a post. See Howto:Rate for rating guidelines.
parent:1234
Sets the post's parent to post #1234.
parent:none, parent:0
Removes the post's parent.
-parent:1234
Removes the post's parent, if the parent was post #1234.
child:1234
Makes post #1234 a child of the current post. Does not directly affect the current post.
child:none
Set the parent to none for all children of the current post.
pool:10
Adds the post to pool #10.
-pool:10
Removes the post from pool #10.
pool:maria-sama_ga_miteru_manga
Adds the post to the "Maria-sama ga Miteru Manga" pool. Does nothing if the pool doesn't already exist. Make sure to replace spaces with underscores.
newpool:maria-sama_ga_miteru_manga
Adds the post to the "Maria-sama ga Miteru Manga" pool, creating the pool if it does not already exist.
source:https://twitter.com/Shatyo3/status/787104029209874432
Sets the source.
source:"(C90) [Hyper Summer Wars (Bomber Grape)] Admiral Prelude (Kantai Collection -KanColle-)"
Sets the source. Use quotes for sources containing spaces.
source:none
Clears the source.
favgroup:cute
Adds the post to the favorite group named "cute" (see Help:Favorite Groups).
-favgroup:cute
Removes the post from the favorite group named "cute" (see Help:Favorite Groups).
fav:self
Favorites the post.
-fav:self
Unfavorites the post.
upvote:self
Votes up a post.
downvote:self
Votes down a post.
status:pending
Sends a post to the modqueue (contributors only, only available on the upload page).
status:active
Approves a post (approvers only).
disapproved:[reason]
Disapproves a post (approvers only).
status:banned
Bans a post (approvers only).
-status:banned
Unbans a post (approvers only).
List of available metatags
- user, -user
- approver, -approver
- disapproved
- commenter (alternative: comm)
- noter
- artcomm
- pool, -pool, newpool, ordpool
- fav, -fav, ordfav
- favgroup, -favgroup
- ordfavgroup
- search
- md5
- rating, -rating
- locked, -locked
- width
- height
- mpixels
- ratio
- score
- favcount
- filesize
- filetype
- duration
- source, -source
- id
- date
- age
- exif
- ai
- status, -status
- pending
- flagged
- deleted
- banned
- active
- any (alternative: all)
- tagcount
- gentags
- arttags
- chartags
- copytags
- metatags
- parent, -parent
- child, -child
- pixiv_id, pixiv
- embedded
- limit
- order
- id
- id_desc
- md5
- md5_asc
- score
- score_asc
- favcount
- favcount_asc
- created_at
- created_at_asc
- change
- change_asc
- comment
- comment_asc
- comment_bumped
- comment_bumped_asc
- note
- note_asc
- artcomm
- artcomm_asc
- mpixels
- mpixels_asc
- portrait
- landscape
- filesize
- filesize_asc
- rank
- curated
- modqueue
- rank
- random
- custom
- none
- count orders (all support _asc)
- tagcount
- arttags
- gentags
- copytags
- chartags
- metatags
- comments
- deleted_comments
- active_comments
- notes
- deleted_notes
- active_notes
- flags
- child_count
- deleted_child_count
- active_child_count
- pools
- deleted_pools
- active_pools
- series_pools
- collection_pools
- appeals
- approvals
- disapprovals
- replacements
- upvote
- downvote
Limitations
Members cannot search for more than two tags at a time. Gold users can search for up to six tags, and Platinum and above users have no restrictions (see Help:Users).
The maximum search duration is limited to 3 seconds for Members, 6 seconds for Gold users, and 9 seconds for Platinum and above users. If your search takes longer than this it will be cancelled. You will see a Search Timeout error when this happens.
Limiting your search to a smaller range of posts, for example by age ({{age:<1year}}), by date ({{date:2016-01-01..2017-01-01}}), or by ID ({{id:1_000_000..2_000_000}}) may prevent timeouts.
Free metatags
These metatags do not count against the tag search limits above:
- rating
- status
- is
- age
- date
- id
- limit
- score
- downvotes
- favcount
- width
- height
- ratio
- mpixels
- filesize
- filetype
- duration
- md5
- pixiv_id, pixiv
- parent
- child
- upvote
- embedded
- tagcount