npm / @react-three/postprocessing

@react-three/postprocessing

What changed in @react-three/postprocessing 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.

3 breaking16 new APIs and options1 behavior and defaults2 tooling4 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@react-three/postprocessing 326 changes

Lowers default multisampling from 8 to 4; pass multisampling={8} to restore the old default.
3.2.0release notes
blendFunction now applies instead of being ignored and always set to ADD.
3.2.0release notes
Requires exactly one of textureSrc or texture; passing both or neither is a type error.
3.2.0release notes

Adds an opacity prop.
3.2.0release notes
Adds an opacity prop.
3.2.0release notes
Adds an opacity prop.
3.2.0release notes
Exports GodRaysProps.
3.2.0release notes
Adds an RGB halftone effect ported from three.js' HalftoneShader.
3.2.0release notes
Adds a painterly filter effect.
3.2.0release notes
Adds an effect that wraps postprocessing's LensDistortionEffect.
3.2.0release notes
Exports LensFlareProps.
3.2.0release notes
Adds a linocut print effect ported from TresJS post-processing.
3.2.0release notes
Adds an opacity prop.
3.2.0release notes
Adds an opacity prop.
3.2.0release notes
Adds an exclude prop to keep a subtree out of an enabled ancestor's selection.
3.2.0release notes
Adds an opacity prop.
3.2.0release notes
Adds a sharpening effect.
3.2.0release notes
Adds an opacity prop.
3.2.0release notes
Exports SSAOProps.
3.2.0release notes

color now accepts any color representation, not just a Color.
3.2.0release notes

Its live props are now typed; they already worked at runtime.
3.2.0release notes
The blendFunction prop is now typed.
3.2.0release notes

Disabling a Select no longer drops objects another Select still selects.
3.2.0release notes
A pre-loaded texture no longer requires textureSrc or triggers a load.
3.2.0release notes
The composer and its passes now resize when only the pixel ratio changes, following the drawing buffer size.
3.1.3release notes
In auto mode, mainUv effects are kept separate from convolution effects, preventing EffectPass from throwing at render time.
3.1.2release notes