Wallhaven Advanced Search Syntax
Wallhaven supports powerful filtering and search syntax to find exactly the wallpapers you're looking for. This guide covers all available search operators.
Where to Use These
All of these operators work in the Search field when you have Search mode selected in the Wallhaven settings. Simply enter the search term with the operators you want to use, and Wallhaven will filter results accordingly.
For more information, visit the official Wallhaven API Documentation or open an issue/discussion on this github repository if you have questions.
Basic Search
Fuzzy Tag Search
tagname
Search fuzzily for a tag or keyword. This will match tags that contain or are similar to your search term.
Example: nature will match "nature", "natural", "scenery", etc.
Advanced Operators
Tag Exclusion
-tagname
Exclude wallpapers with a specific tag or keyword.
Example: -people will exclude all wallpapers tagged with people.
How to find tags to exclude: Visit Wallhaven Tags and look through the list, or search for a wallpaper you like and see what tags are applied to it.
Multiple Tags (Must Have All)
+tag1 +tag2
Find wallpapers that have ALL specified tags. The + prefix is required.
Example: +anime +dark will only show wallpapers tagged with both anime AND dark.
How to find tags: Visit Wallhaven Tags and look through the list, or search for a wallpaper you like and see what tags are applied to it.
Combination: Include and Exclude
+tag1 -tag2
Find wallpapers with specific tags while excluding others.
Example: +landscape -dark will show landscape wallpapers that are not dark.
User Uploads
@username
Find all wallpapers uploaded by a specific user.
Example: @sergiucoj will show all wallpapers uploaded by the user sergiucoj
How to find usernames: Find a wallpaper you like, visit the detail page, and click on the uploader's name to see their profile.
Exact Tag Search
id:123
Search for a specific tag by its exact ID. This cannot be combined with other search operators.
Example: id:320 will search for the exact tag with ID 320.
How to find tag IDs: Visit Wallhaven Tags, click on any tag, and the ID will be in the URL (e.g., wallhaven.cc/tags/show/320). Alternatively, inspect a wallpaper's detail page to see tag IDs.
File Type Search
type:{png/jpg}
Filter wallpapers by file type. Supported types: png, jpg (or jpeg). You probably won't ever use this, but it's available if you do.
Example: type:png will only show PNG wallpapers.
Similar Wallpapers
like:wallpaper ID
Find wallpapers with similar tags to a specific wallpaper.
Example: like:abc123 will find wallpapers similar to wallpaper ID abc123.
Combined Examples
+anime -nsfw type:png— PNG anime wallpapers excluding NSFW contentlandscape @admin— Landscape wallpapers from admin user+space +dark -people— Dark space wallpapers without peoplenature type:jpg— Nature photography in JPEG format
Usage Tips
- Category and Purity filters work independently of these search operators
- Operators are additive — combine multiple operators for precise results
- Order matters — arrange operators as needed (no specific order required)
- Tags are case-insensitive —
Natureandnaturework the same - Visit Wallhaven directly for more detailed information at wallhaven.cc or check their full API documentation