Help: 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.

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:Bob Posts uploaded by Bob
user:!17633 Posts uploaded by a user with the ID # 17633, rather than the name "17633"
favoritedby:Bobfav:BobPosts favorited by Bob
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:Bob Posts approved by Bob
deletedby:Bob Posts deleted by Bob
commenter:Bob Posts commented on by Bob
noteupdater:Bob Posts with notes updated by Bob

Post-Based Metatags ^

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

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
date:year..monthPosts uploaded between 30 days ago and 1 year ago
filesize:200KB..300KBPosts with a file size between 200 kilobytes and 300 kilobytes
score:25..50Posts 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)

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
dirtags:2 Posts with exactly 2 director tags range
chartags:2 Posts with exactly 2 character tagsrange
spectags:2 Posts with exactly 2 species tags range
invtags:2 Posts with exactly 2 invalid tags range

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 two digits, therefore 1.33 will return posts with a ratio of 4:3. range
filesize:200KB Posts with a file size of 200 kilobytes. File sizes within ±5% of the value are included. range
filesize:2MB Posts with a file size of 2 megabytes. File sizes within ±5% of the value are included. range

Video Duration
Video Duration What it does Supported syntax
duration:>120 Posts with a duration of at least 120 seconds range

Dates:

Single day What it does Supported syntax
date:2012-04-27 date:april/27/2012Search 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 yesterdayrange

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 daysrange, ago, yester
date:decade Posts from the last decade range*

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_agoPosts from within the last 5 monthsrange**, yester
date:5_years_ago Posts from within the last 5 years range**, yester

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

*Only x..decade is supported (e.g., date:decade..year)
**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.

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:gif Posts that are GIF, a type of image (may be animated)
type:swf Posts that are Flash, a format used for animation
type:webm Posts that are WebM, a type of video

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"
notes: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)

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:any All active or deleted posts

Other
Other What it does
hassource:true hassource:false Posts with or without a source
hasdescription:truehasdescription: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
pool:4 pool:fox_and_the_grapesPosts in the pool "Fox and the Grapes"
set:17 set:cute_rabbits Posts in the set with the short name "cute_rabbits"
md5:02dd0... Post with the given MD5 hash. MD5 hashes will never be shared by more than one image.

Sorting ^

By default, posts are ordered from highest ID to lowest ID (newest posts first). This is the same as order:-id.

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

*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.