# The Poly Haven add-on pulls the whole library into Blender's Asset Browser

> polyhavenassets is a Blender add-on that downloads Poly Haven's textures and HDRIs and lists them by category in the Asset Browser, then adds the things the manual workflow leaves you to do by hand: resolution swapping, real-world texture scale, one-click displacement and HDRI sliders. The add-on is sold commercially while the assets it serves stay free, and the initial fetch pulls the entire collection.

**Poly-Haven/polyhavenassets** — A Blender add-on to integrate our assets natively in the asset browser

- Repository: https://github.com/Poly-Haven/polyhavenassets
- Stars: 530 · Forks: 36
- Language: Python
- License: GPL-3.0
- Published: 2026-10-22 · Updated: 2026-10-22 · Language: en
- Canonical page: https://hysenlabs.com/projects/poly-haven-polyhavenassets

## What the add-on does once it is enabled

Poly Haven publishes thousands of free textures and HDRIs, and Blender's Asset Browser is where you would want them. The gap is that the Asset Browser expects a local library on disk, laid out the way Blender wants, with catalogs, and Poly Haven's site does not hand you that. This add-on is the glue.

The first feature is the core of it: the add-on downloads all assets from Poly Haven and lists them under their respective categories in the Asset Browser. Once that is done, the library behaves like any other asset library inside Blender, and the assets can be dragged into a scene.

The remaining four features are about the work that follows an import, which is where most of the value sits. The add-on lets you swap an asset to a higher or lower resolution at any point after import, and most assets are available at 8K or better, so the 2K version you fetched for a quick look does not have to be the one you keep. It sets the texture mapping scale to the correct real-world size for the surfaces you applied it to, which is the step that decides whether a brick wall reads as brick or as wallpaper. It offers a one-click setup of texture displacement with adaptive subdivision, saving you from the usual subdivision tuning. And it puts rotation, brightness and color temperature sliders on HDRIs.

The audience is Blender artists and technical artists who already trust Poly Haven's assets and want the housekeeping done consistently. If you download one texture per project and set it up by hand, the add-on solves a problem you do not have.

## Resolution swapping and the real-world scale question

Two of the features are worth separating, because they solve different problems and one of them is easy to underestimate.

Resolution swapping is a bandwidth and memory feature. Poly Haven serves the same asset at several sizes, and the add-on tracks those variants for assets you have already imported, so changing a 1K texture to a 4K one is a click rather than a fresh download and a manual re-import. Since the README notes that most assets are at least 8K, the ceiling is high and the practical question is how much of that you want in a given scene.

Real-world scale is a correctness feature. A texture carries a physical size, and Blender's mapping scale decides how that size maps onto your geometry. Apply a 2 metre concrete floor texture to a 2 centimetre model prop and the pattern is wrong by a factor of a hundred, and no amount of shader tweaking fixes it convincingly. The add-on sets the mapping scale according to the surfaces you applied the texture to, which means the texture behaves like the real object it represents at any scene scale.

That second feature is the one with no manual equivalent worth doing by hand, and it is also the one the README gives the least detail about. It does not say which Blender measurements it reads, whether it needs a physically scaled scene unit setting, or how it handles a texture used on several objects of different sizes. Treat that as something to check on your own files, because getting it wrong is silent: the render looks plausible and the scale is still wrong.

## Displacement setup and the HDRI sliders

The displacement feature is described as a one-click setup of texture displacement with adaptive subdivision. Both halves of that matter. Turning a greyscale height map into visible surface detail needs geometry density, and Blender's adaptive subdivision adds that density where the map needs it without forcing you to subdivide the whole model, which is where the performance cost of displacement usually comes from. Automating the setup means you do not have to remember the modifier stack, the subdivision level and the displacement strength for every new texture.

The HDRI controls are simpler and more immediately visible: rotation, brightness and color temperature. These are the three adjustments that decide whether an environment light flatters or distorts a render, and sliders in the add-on save you from opening the image editor for a rotation of a few degrees or a slight warm-up of the highlights.

What these features have in common is that they are conveniences on top of the asset download. That is worth keeping in mind when you read the feature list as a whole: the add-on's first job is moving files, and the rest of the list is there to remove the fiddly steps that follow. If your pipeline already has a house style for scale, displacement and HDRI setup, some of that value is redundant, and if it does not, the first feature alone would not be worth a paid add-on.

## Installing the ZIP and pointing Blender at it

Installation is short, and the one detail that trips people up is that the file must not be unpacked.

```markdown
2. Install the zip file from Blender's User Preferences (do not unzip it first).
3. Enable the add-on.
```

The ZIP comes from the Superhive account page if you bought it there, or from the Patreon post if you support the project that way. Blender installs add-ons from the Preferences add-ons view, and the add-on is then enabled there.

The first run is where the time goes. The usage steps in the README are explicit about the order: create a new asset library in preferences named Poly Haven, which is the folder the assets download into, open the asset browser editor, pick that library in the top left, and press the fetch button in the header.

```markdown
4. After the initial download (which currently is around 3.3GB), simply drag and drop the assets into your scene.
5. We release new assets almost daily, so you can click that *Fetch Assets* button any time to download new assets.
```

The 3.3GB figure is the number to plan around, and it is a full fetch rather than a partial one. Updating the add-on itself is a separate operation from fetching assets, and it happens inside Blender.

```markdown
To check for a new version of the add-on, simply visit the add-on's Preferences in Blender and click the *Check now for update* button.
```

## The download-everything model is the design constraint

The clearest limitation is that the add-on fetches everything. The README says it downloads all assets from Poly Haven, and the initial download is around 3.3GB, with no mention of a way to fetch a single category, a single asset or a filtered set. A user with a small SSD, a metered connection or a company laptop policy will pay that cost once, and the README does not document a selective alternative, an offline mode or what happens when the download is interrupted partway.

The second constraint is that the library depends on polyhaven.com being reachable. The add-on is a client of a website it does not control, so a change to the site's API or its asset URLs is a change to the add-on, and the repository's own update mechanism exists for the add-on code rather than for the site.

The third is the workflow coupling. Assets land in a library you create in Blender preferences, and the categories come from a file the add-on maintains. If you already have a curated local texture library with your own naming and catalogs, the add-on does not merge into it, it adds a second library alongside it.

A note on the version numbers: the releases v1.2.3, v1.2.2 and v1.2.1 with the last push on 2026-10-02 indicate a project that is still being worked on, which is good news for a paid add-on whose asset library grows constantly, and a reminder that the add-on and the library have separate cadences.

## A paid add-on in front of a free library

The commercial arrangement deserves a plain reading, because it decides what you are actually buying.

Poly Haven's own assets are free to download. The README states that all of their assets are 100% free to download and that creating them costs a lot, and it says the add-on was sold so that the work could continue, with the claim that over a thousand new assets were created as a result. The add-on itself is meant to be purchased on Superhive or obtained through a Patreon subscription, and the README states the intention to stop selling it, releasing it free to everyone once a patron target of 5000 is reached, with a blog post linked about that plan.

So the add-on is a paid tool for free content, with a stated plan to make it free. That is unusual, and it is the kind of arrangement a buyer has to weigh rather than assume: you may be paying for a tool that becomes free, or you may be funding assets you could have downloaded anyway.

One more detail to check before you decide. The repository carries a LICENSE file, and the licence field on the repository is recorded as GPL-3.0, while the add-on is distributed as a paid ZIP through a marketplace and a Patreon post. Read the LICENSE file in the repository yourself for the terms that apply to the code, and the terms of your purchase, rather than assuming they are the same thing. This is not a legal opinion, just a reminder that a copyleft licence and a commercial marketplace listing are two different signals worth reading.

For a lighter alternative, the assets themselves are free from polyhaven.com, and Blender can be pointed at a folder of them as an asset library by hand. The difference is exactly the feature list above: without the add-on you download files yourself, name and catalog them yourself, and you keep doing the scale, displacement and HDRI work by hand.

## What a Blender add-on repository looks like inside

The repository layout is small and maps directly onto how a Blender add-on is built, which is a decent sanity check on the scope of the project.

At the top level there is an __init__.py, which is where Blender expects the add-on's registration to live, and constants.py for shared values. The update mechanism is a separate pair of files, addon_updater.py and addon_updater_ops.py, which is what backs the check for update button in the add-on's preferences. A file named blender_assets.cats.txt holds the asset catalog definitions the Asset Browser uses to group entries into categories. The rest is organised by role: operators/ for the actions the add-on exposes, ui/ for panels and menus, utils/ for helpers, icons.py plus an icons/ folder for the artwork, and ephemeral.py for state that should not be saved with the blend file.

There is also a .github directory, a .vscode directory, an .idea directory and a LICENSE file, which is a conventional setup for a Python add-on maintained in a text editor with editor-specific settings shared through the repository.

The most useful thing this layout tells a buyer is the shape of the maintenance burden: the code is small, the risky part is the network and API side of talking to polyhaven.com, and the asset categories file is what you would inspect if the Asset Browser grouping looked wrong.

## Conclusion

Poly Haven Assets suits a Blender artist who already works with Poly Haven textures and wants them in the Asset Browser with correct scale and displacement set up for them, and it suits nobody who wants a light install, since the first Fetch Assets downloads the entire collection. Before paying for it, check the current price and the liberation promise on the README, and confirm that 3.3GB of initial download and a paid add-on fit your workflow, because the assets themselves are free to download from polyhaven.com. The last push was on 2026-10-02 and the newest release is v1.2.3 from 2026-07-20, under a GPL-3.0 licence file.

## FAQ

### How do I install the Poly Haven Assets Blender add-on?

The add-on is installed as a ZIP from Blender's User Preferences, and the README stresses that you should not unzip the file first. The ZIP comes from your Superhive account page or from the Patreon post, and you then enable the add-on from the same preferences view.

### How much does the Poly Haven Assets add-on download?

The README states that the initial download is currently around 3.3GB, because the add-on downloads all assets from Poly Haven and lists them by category in the Asset Browser. New assets are picked up by pressing the Fetch Assets button again.

### What does the Poly Haven add-on do that downloading the textures manually does not?

It lists the assets in the Asset Browser, lets you swap an asset to a higher or lower resolution after import, sets the texture mapping scale to the correct real-world size for the surfaces you applied it to, sets up texture displacement with adaptive subdivision, and adds rotation, brightness and color temperature sliders for HDRIs.

### Is the Poly Haven Assets add-on free?

Not at the moment. The README says it is meant to be purchased on Superhive or obtained through a Patreon subscription to support the work of creating free assets, and it states an intention to release the add-on for free to everyone once a patron target of 5000 is reached.

### How do I update the Poly Haven Assets add-on?

You open the add-on's Preferences in Blender and click the Check now for update button. The README also says you can download the latest version and install the ZIP again from your Superhive account page or from the Patreon post.

## Sources

- [Issues](https://github.com/Poly-Haven/polyhavenassets/issues)
- [License: GPL-3.0](https://github.com/Poly-Haven/polyhavenassets/blob/main/LICENSE)
- [Poly-Haven/polyhavenassets on GitHub](https://github.com/Poly-Haven/polyhavenassets)
- [README](https://github.com/Poly-Haven/polyhavenassets/blob/main/README.md)
- [Releases](https://github.com/Poly-Haven/polyhavenassets/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/poly-haven-polyhavenassets