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.

• Basics
• User Metatags
• Post Metatags
• Range Syntax
• Counts
• Image Size
• Video Duration
• Dates
• Single Day
• Simple Time Period
• Ago Syntax
• Yester Syntax
• Rating
• File Types
• Text Searching
• Parents and Children
• Status
• Other
• Sorting

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

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

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 tags	range
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/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.

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

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.