Frequently Asked Questions

Wallhaven FAQ

Answers to the most common questions about the Wallhaven platform.

General

What is Wallhaven?
Wallhaven is a free community-driven wallpaper platform hosting over one million high-resolution images. It covers general photography, anime illustration, and people-focused art. The platform is available at wallhaven.pics.
Is Wallhaven completely free?
Yes. Browsing and downloading SFW wallpapers is free with no subscription required. A free account unlocks additional features: personal collections, API key access, and opt-in content tiers.
Do I need an account to download wallpapers?
No. All SFW wallpapers can be downloaded without creating an account. An account is only required for Sketchy or NSFW content tiers, building personal collections, and generating an API key.
What is Wallhaven's purity system?
Three tiers: SFW (safe for work, accessible to all), Sketchy (mildly suggestive, requires a registered account), and NSFW (explicit adult content, requires an account and explicit opt-in in settings).
Is Wallhaven safe to use?
Yes. SFW content is moderated and does not contain adult material. NSFW content is gated behind account registration and explicit opt-in. The website operates over HTTPS.

Searching & Browsing

How do I search for wallpapers on Wallhaven?
Use the search bar at wallhaven.pics/search. Enter any keyword or tag. Use + to combine required tags (anime+dark) and a minus prefix to exclude tags (nature -snow). Full guide at How to Use.
How do I filter by resolution?
In advanced search, set an exact resolution like 3840x2160 for 4K, or filter by aspect ratio like 16x9, 21x9 for ultrawide, or 9x16 for portrait/mobile.
Can I search by color?
Yes. Wallhaven's color filter accepts a hex color code and returns wallpapers where that color is the dominant one in the image. Enter the hex directly or use the color picker in advanced search.
What categories does Wallhaven have?
Three: General (landscapes, nature, architecture, space, abstract), Anime (anime and manga art), and People (photography and art featuring people). Each is independently toggleable in search.
How do I find the most popular wallpapers?
Sort search results by "Toplist" and set the time range. Options include top of the past day, week, month, 3 months, 6 months, year, or all time. Visit wallhaven.pics/toplist for the all-time top list.

Downloading

How do I download a wallpaper?
Open any wallpaper page on wallhaven.pics and click the download button. You can also right-click the full-resolution image and save it. No account required for SFW content.
What file formats are available?
JPEG, PNG, and GIF — depending on what the uploader submitted. Downloads are always the original file in its original format with no re-compression or watermark.
Can I download wallpapers in bulk?
Bulk download is not available through the web interface, but you can use the Wallhaven API to retrieve direct image URLs programmatically and download them in a script.
Are Wallhaven wallpapers free to use?
Wallhaven hosts user-submitted content. Community-uploaded artwork, photography, and fan art may have varying rights. Check the individual wallpaper's source and uploader notes for licensing information before commercial use.

Accounts & Features

How do I create a Wallhaven account?
Visit wallhaven.pics and click Register. You need only a username, email address, and password. Registration is free and requires no payment details.
Can I upload wallpapers to Wallhaven?
Yes. Registered users can upload wallpapers that meet the platform's minimum resolution and quality standards. Uploads go through community review before entering the main library.
How do Wallhaven collections work?
Registered users can save wallpapers to named personal collections. Collections can be kept private or shared publicly. Other users can follow public collections. Collections are also accessible via the API.
Does Wallhaven have a mobile app?
There is no official Wallhaven mobile app. The website is fully responsive and works well on mobile browsers. Several third-party apps built on the Wallhaven API are available for Android and iOS through app stores.

API & Developers

Does Wallhaven have an API?
Yes. Wallhaven provides a public REST API (v1) at https://wallhaven.cc/api/v1/. It supports search, single-wallpaper lookup, tag queries, and collection access. Full reference: API Guide.
Do I need an API key?
An API key is not required for SFW search requests. It is required to access Sketchy/NSFW content through the API and for collection endpoints. Generate a key in Account Settings on Wallhaven.
What does the API return?
JSON responses with a data array of wallpaper objects and a meta object with pagination info. Each wallpaper object includes the ID, resolution, direct image URL (path), thumbnail URLs, tags, colors, and metadata.
More detailed guides: Platform Guide · How to Use Wallhaven · API Reference