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.
- User Metatags
- Post Metatags
- Range Syntax
- Image Size
- Video Duration
- File Types
- Text Searching
- Parents and Children
These tags and syntaxes are used to search for posts.
Search for posts that are tagged with both cat and dog. Tags are separated by spaces.
Words within each tag are separated by underscores.
Search for posts that are tagged either cat or dog (or both). May not work well when combined with other syntaxes.
Search for posts that don't have the chicken tag.
Search for posts that are tagged with fox and are not tagged with chicken.
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:Bob fav:Bob Posts 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.
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..month Posts uploaded between 30 days ago and 1 year ago filesize:200KB..300KB Posts with a file size between 200 kilobytes and 300 kilobytes 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)
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 tags range spectags:2 Posts with exactly 2 species tags range invtags:2 Posts with exactly 2 invalid tags range
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 What it does Supported syntax duration:>120 Posts with a duration of at least 120 seconds range
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*
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
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 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.
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
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 pool:4 pool:fox_and_the_grapes Posts 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.
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.