help:cheatsheet (locked)
Table of Contents
- 1. Searching
- 2. Metatags
- 2.1 User qualifiers
- 2.1.1 Users
- 2.1.2 Favorites
- 2.1.3 Approvers
- 2.1.4 Comments
- 2.1.5 Notes
- 2.1.6 Flags
- 2.1.7 Appeals
- 2.1.8 Artist Commentaries
- 2.1.9 Favorite Groups
- 2.1.10 Saved Searches
- 2.2 Range qualifiers
- 2.3 Post qualifiers
- 2.3.1 Status
- 2.3.2 Ratings
- 2.3.3 Source
- 2.3.4 Pixiv ID
- 2.3.5 Parent/child
- 2.3.6 Tag counts
- 2.3.7 Score
- 2.3.8 Disapproved
- 2.3.9 Post changes
- 2.4 Image qualifiers
- 2.4.1 MD5 hash
- 2.4.2 Dimensions
- 2.4.3 Ratio
- 2.4.4 Megapixels
- 2.4.5 Filesize
- 2.4.6 Filetype
- 2.5 is: and has:
- 2.6 Pools
- 2.7 Abbreviations
- 2.8 Others
- 3. Tagging
- 4. List of available metatags
- 5. Limitations
- 5.1 Free metatags
- 6. See also
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.
-blonde_hair -blue_eyes
Search for posts that don't have blonde hair or blue eyes.
blonde_hair *_(cosplay)
Search for posts that have blonde hair and at least one tag ending with "_(cosplay)". Note: This won't match every *_(cosplay) tag; the number of matches is limited by your tag limit (see Limitations below).
-(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.
Legacy disjunctive operator, equivalent to blonde_hair or blue_eyes.
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.
order:curated
Order search results by most favorited by users with unrestricted uploads.
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.
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:unmoderated
Search for posts that are currently pending and that the searcher has not made a judgement on (only works for approvers).
status:flagged
Search for posts that are currently flagged. Use flagger:any to find posts that have ever been flagged.
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.
source:https://i.pximg.net
Search for posts with a source that starts with https://i.pximg.net (pixiv's direct URL).
-source:https://i.pximg.net
Search for posts that do not have a source starting with https://i.pximg.net (pixiv's direct URL).
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.
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.
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).
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
has:metadata
Search for posts with any AI metadata set.
has:prompt
Search for posts with their prompt available.
has:seed
Search for posts with their seed available.
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.
downvote:username
Searches for posts downvoted by the user. Only Admins can see downvotes 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.
random:N
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:active
Approves 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
- source, -source
- id
- date
- age
- 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
- children
- deleted_children
- active_children
- pools
- deleted_pools
- active_pools
- series_pools
- collection_pools
- appeals
- approvals
- replacements
- upvote
- downvote
Limitations
Members cannot search for more than two tags at a time.
The maximum search duration is limited to 3 seconds for Members, and 9 seconds for Builder 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 adding age:<1year or date:2016-01-01..2017-01-01, 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