Help: Cheatsheet

← Wiki Home – Cheatsheet
Contents: Basics | Sorting | User Metatags | Range Syntax
Post Metatags:
– Counts
– Rating
– File Types
– Image Size
– Status
– Dates
– Text Searching
– Parents and Children
– Other

Cheatsheet

This page lists every metatag available for tagging and searching, as well as additional information about syntax. For basic information about tags, what they are, and how to use them, see the tag help page.
These tags and syntaxes are used to search for posts.

Basics

cat dog
Search for posts that are tagged with both cat and dog. Tags are separated by spaces.

red_panda african_wild_dog
Words within each tag are separated by underscores.

~cat ~dog
Search for posts that are tagged either cat or dog (or both). May not work well when combined with other syntaxes.

-chicken
Search for posts that don't have the chicken tag.

fox -chicken
Search for posts that are tagged with fox and are not tagged with chicken.

african_*
Search for posts with any tag that starts with african_, such as african_wild_dog or african_golden_cat. May not work well when combined with other syntaxes.
Limit one wildcard per search.

Sorting

By default, posts are ordered from highest ID to lowest ID (newest posts first). This is the same as order:id.
Adding the "limit:" metatag will increase or decrease the number of posts per page, otherwise following the normal rules for your current sorting method.

votedup:me order:random limit:1 will return a single post that you have upvoted, with no pagination.
order:id_asc limit:1 will display the single oldest post, with the next pages containing the second oldest, the third oldest, etc.
limit:10 will display the 10 newest posts, with the next pages containing posts 11 through 20, 21 through 30, etc.

Search	What it does	Search	What it does
order:id	Oldest to newest	order:random	Orders posts randomly *
order:score	Highest score first	order:score_asc	Lowest score first
order:favcount	Most favorites first	order:favcount_asc	Least favorites first
order:tagcount	Most tags first	order:tagcount_asc	Least tags first
order:comment_count	Most comments first	order:comment_count_asc	Least comments first
order:comment_bumped	Posts with the newest comments	order:comment_bumped_asc	Posts that have not been commented on for the longest time
order:mpixels	Largest resolution first	order:mpixels_asc	Smallest resolution first
order:filesize	Largest file size first	order:filesize_asc	Smallest file size first
order:landscape	Wide and short to tall and thin	order:portrait	Tall and thin to wide and short
order:change	Sorts by last update sequence
order:duration	Video duration longest to shortest	order:duration_asc	Video duration shortest to longest
order:framecount	Framecount from most to least	order:framecount_asc	Framecount from least to most
order:views	Viewsfrom most to least	order:views_asc	Views from least to most **

* If you need deterministic results, add randseed:123 to your search. Passing the same seed will return the same set of random posts. This supports pagination, and the following pages will contain no duplicates.
** View counts are only updated hourly due to performance limitations.

User-Based Metatags

These metatags are used to search for posts based on user-related information.

The basic form is metatag:username (e.g., favoritedby:Bob)

Search	What it does
user:Foxy	Posts uploaded by Foxy
user:!5	Posts uploaded by a user with ID #5, rather than the name "5"
fav:Foxy	Posts favorited by Foxy
voted:anything	Posts you voted on. Only works while logged in.
votedup:anything	Posts you upvoted. Only works while logged in.
voteddown:anything	Posts you downvoted. Only works while logged in.
approver:Foxy	Posts approved by Foxy
deletedby:Foxy	Posts deleted by Foxy
commenter:Foxy	Posts commented on by Foxy
noteupdater:Foxy	Posts with notes updated by Foxy

Post-Based Metatags

These metatags are used to search for posts based on post-related information.

Counts

Tag counts	What it does	Supported syntax
id:100	Post with an ID of 100	range
score:100	Posts with a score of 100	range
favcount:100	Posts with exactly 100 favorites	range
comment_count:100	Posts with exactly 100 comments	range
tagcount:2	Posts with exactly 2 tags	range
gentags:2	Posts with exactly 2 general tags	range
vatags:2	Posts with exactly 2 voice actor tags	range
arttags:2	Posts with exactly 2 artist tags	range
chartags:2	Posts with exactly 2 character tags	range
copytags:2	Posts with exactly 2 copyright tags	range
spectags:2	Posts with exactly 2 species tags	range
invtags:2	Posts with exactly 2 invalid tags	range
lortags:2	Posts with exactly 2 lore tags	range
metatags:2	Posts with exactly 2 meta tags	range
gendertags:2	Posts with exactly 2 gender tags	range

Rating

Rating		What it does
rating:safe	rating:s	Posts rated safe
rating:questionable	rating:q	Posts rated questionable
rating:explicit	rating:e	Posts rated explicit

File Types

File types	What it does
type:jpg	Posts that are JPG, a type of image
type:png	Posts that are PNG, a type of image
type:webp	Posts that are WebP, a type of image
type:gif	Posts that are GIF, a type of image (may be animated)
type:webm	Posts that are WebM, a type of video

Image Size

Image Size	What it does	Supported syntax
width:100	Posts with a width of 100 pixels	range
height:100	Posts with a length of 100 pixels	range
mpixels:1	Posts that are 1 megapixel (a 1000x1000 image equals 1 megapixel)	range
ratio:1.33	Search for posts with a ratio of 4:3. All ratios are rounded to ten digits.	range
filesize:200KB	Posts with a file size of 200 kibibytes. File sizes within ±5% of the value are included.	range
filesize:2MB	Posts with a file size of 2 mebibytes. * File sizes within ±5% of the value are included.	range

*Filesizes are parsed in powers of 2 (1 MiB = 1024 KiB), not 10 (1 MB = 1000 KB).

Post Status

Post status	What it does
status:pending	Posts that are waiting to be approved or deleted
status:active	Posts that have been approved
status:deleted	Posts that have been deleted
status:flagged	Posts that are flagged for deletion
status:modqueue	Posts that are pending or flagged
status:any	All active or deleted posts

Dates

Single day		What it does	Supported syntax
date:2012-04-27	date:april/27/2012	Search for posts uploaded on a specific date. (assumes year-month-day format by default)	range
date:today	date:yesterday	Same as above, but specific to today and yesterday	range

Simple time period	What it does	Supported syntax
date:day	Posts from the last day	range, ago, yester
date:week	Posts from the last 7 days	range, ago, yester
date:month	Posts from the last 30 days	range, ago, yester
date:year	Posts from the last 365 days	range, ago, yester
date:decade	Posts from the last decade	range*

*Only x..decade is supported (e.g., date:decade..year)

Ago syntax	What it does	Supported syntax
date:5_days_ago	Posts from within the last 5 days	range**
date:5_weeks_ago	Posts from within the last 5 weeks	range**, yester
date:5_months_ago	Posts from within the last 5 months	range**, yester
date:5_years_ago	Posts from within the last 5 years	range**, yester

**If used as the first of a range, will start at the first day of that range. For example, date:year..month will range from 30 days ago to 1 year ago.

Yester syntax	What it does	Supported syntax
date:yesterweek	Posts from last week	ago
date:yestermonth	Posts from last month	ago
date:yesteryear	Posts from last year	ago
date:5_yesteryears_ago	Posts during the year 2015 (if it is currently 2020)

Text Searching

Text searching	What it does
source:*example.com	Posts with a source that contains "example.com", prefix matched, use wildcards as needed
source:none	Posts without a source
description:whatever	Posts with a description that contains the text "whatever".
description:"hello there"	Posts with a description that contains the text "hello there".
note:whatever	Posts with a note that contains the text "whatever"
delreason:*whatever	Deleted posts that contain a reason with the text "whatever", prefix matched, use wildcards as needed

Parents and Children

Parents and Children		What it does
ischild:true	ischild:false	Posts that are or aren't a child
isparent:true	isparent:false	Posts that are or aren't a parent
parent:1234		Posts with a parent of 1234
parent:none		Posts with no parent (same as ischild:false)

Other

Other		What it does
hassource:true	hassource:false	Posts with or without a source
hasdescription:true	hasdescription:false	Posts with or without a description
ratinglocked:true	ratinglocked:false	Posts with rating (un)locked
notelocked:true	notelocked:false	Posts with notes (un)locked
inpool:true	inpool:false	Posts that are or aren't in a pool
pending_replacements:true	pending_replacements:false	Posts that have or don't have any pending replacements
artverified:true	artverified:false	Posts whose uploader is or isn't a verified artist
pool:1	pool:name	Posts in the pool "name"
set:1	set:name	Posts in the set with the short name "name"
md5:02dd0...		Post with the given MD5 hash. MD5 hashes will never be shared by more than one image.
duration:>120		Videos with a duration of at least 120 seconds
framecount:>120		Videos with at least 120 frames

Range Syntax

Some of the following metatags support searching for a range of values:

Search	What it does
id:100	Post with an ID of exactly 100. A comma separated list of up to 100 can be provided.
date:year..month	Posts uploaded between 30 days ago and 1 year ago
filesize:200KB..300KB	Posts with a file size between 200 kibibytes and 300 kibibytes
score:25..50	Posts with a score between 25 and 50
score:>=100	Posts with a score of 100 or greater (100+)
score:>100	Posts with a score greater than 100 (101+)
favcount:<=100	Posts with 100 or less favorites (0-100)
favcount:<100	Posts with less than 100 favorites (0-99)