Unity HDRP Rendering Issues - How to Fix (High Definition Pipeline)
Problem: Your Unity project uses the High Definition Render Pipeline (HDRP) but you see pink or magenta materials, a black or very dark scene, broken lighting, or nothing renders in the Game or Scene view.
Quick Solution: Confirm your project is set to HDRP and that materials, shaders, and lights are HDRP-compatible. Fix the default volume and scene lighting, assign HDRP materials to meshes, and ensure the correct pipeline asset is in use. This guide walks you through the most common HDRP rendering fixes.
Why HDRP Rendering Breaks
HDRP uses its own shaders, lighting model, and pipeline assets. Common causes of rendering issues include:
- Built-in or URP materials used in an HDRP project (they show pink/magenta because the shader is not HDRP).
- No or wrong HDRP Volume in the scene (no default lighting or post-processing).
- Camera or Frame Settings not set for HDRP (e.g. wrong anti-aliasing or rendering path).
- Lights not HDRP or intensity/color in the wrong range for HDRP.
- Project not actually using HDRP (wrong pipeline asset in Graphics or Quality settings).
Fixing these in order (pipeline → materials → lighting → volume) usually restores correct rendering.
Solution 1: Confirm HDRP Is Active
If the wrong pipeline is assigned, the whole scene can look wrong or not render.
Step-by-Step Fix
-
Open Project Settings
- Go to Edit > Project Settings.
-
Check Graphics
- Open Graphics. Under Scriptable Render Pipeline Settings, the assigned asset should be an HDRP Asset (e.g.
HDRPDefaultSettingsor your custom HDRP asset). If it is None or a URP/Built-in asset, HDRP is not active.
- Open Graphics. Under Scriptable Render Pipeline Settings, the assigned asset should be an HDRP Asset (e.g.
-
Check Quality
- Open Quality. For each quality level you use, ensure Render Pipeline Asset is set to your HDRP asset (same as in Graphics, or a quality-specific HDRP asset).
-
Fix if wrong
- If the project is meant to be HDRP: create or import the HDRP package (Package Manager > High Definition RP), then assign the HDRP default asset (or your custom one) in Graphics and Quality. If the project was Built-in or URP and you switched, you must convert materials and lighting to HDRP (see below).
Verification: After assigning the HDRP asset and entering Play mode or opening a scene, the Game view should use HDRP (no pink shaders from wrong pipeline). If materials are still pink, they are the issue (Solution 2).
Solution 2: Fix Pink or Missing Materials (HDRP Shaders)
Pink or magenta usually means the material’s shader is not available or not HDRP-compatible.
Step-by-Step Fix
-
Select the pink object
- In the Scene or Hierarchy, select the object with the pink material.
-
Check the Material
- In the Inspector, open the Material (or Materials list). The Shader field will often show Hidden/InternalErrorShader or a Built-in/URP shader name (e.g. Standard, URP/Lit).
-
Assign an HDRP shader
- Click the Shader dropdown and choose an HDRP shader, e.g. HDRP > Lit, HDRP > Unlit, or HDRP > Decal. Reassign the texture and settings (albedo, normal, etc.) as needed. HDRP Lit uses base color, normal, and optional metallic/smoothness like the old Standard but in HDRP form.
-
Convert many materials at once
- If you have many Built-in or URP materials: use Edit > Render Pipeline > HDRP > Convert Built-in Materials to HDRP (or the equivalent for your Unity version). This tries to convert materials in the project to HDRP Lit. Check the result and fix any that stay pink.
-
Re-import assets
- For imported 3D models: select the model in the Project window, in the Inspector open the Materials tab, and set Location to use project materials, then assign or create HDRP materials for each slot. Or run the HDRP material conversion and then reassign if needed.
Verification: Previously pink objects now show the correct material and color. If the scene is still black or dark, the issue is lighting or volume (Solutions 3 and 4).
Solution 3: Fix a Dark or Black Scene (Lighting and Sky)
In HDRP, the scene can be black if there is no valid sky or no HDRP light (or intensity is zero).
Step-by-Step Fix
-
Add or fix the Volume
- HDRP uses Volumes for global settings. Ensure the scene has a Global Volume (or a Volume that affects the main camera). Add one via GameObject > Volume > Global Volume. In the Volume, add an HDRP override such as Visual Environment (and optionally Fog, Exposure). In Visual Environment, set Sky Type to HDRI Sky (or Gradient Sky) and assign an HDRI or gradient so the sky and ambient are not black.
-
Add an HDRP Light
- Add Directional Light (or other HDRP light): GameObject > Light > Directional Light. Ensure the light’s Intensity is in a sensible range for HDRP (e.g. 1–10 for a sun). If the light was created for Built-in, it may need its intensity adjusted for HDRP.
-
Check the camera
- Select the Main Camera. In the Inspector, ensure it uses HDRP (no override that disables rendering). If there is a HD Additional Camera Data component, leave default or adjust exposure if the image is too bright/dark.
-
Bake or real-time
- For static lighting you can use HDRP’s Lighting window and bake. For a quick fix, real-time directional + HDRI sky is enough to see the scene.
Verification: The Scene and Game views show a visible sky and lit objects. If it’s still wrong, check the pipeline asset and Frame Settings (Solution 4).
Solution 4: Pipeline Asset and Frame Settings
Incorrect HDRP Asset or Frame Settings can cause missing effects or odd rendering.
Step-by-Step Fix
-
Select the HDRP Asset
- In the Project window, select the HDRP asset assigned in Graphics (e.g.
HDRPDefaultSettings).
- In the Project window, select the HDRP asset assigned in Graphics (e.g.
-
Check Frame Settings
- In the Inspector, review Default Frame Settings (Rendering, Lighting, etc.). Ensure options you need are enabled (e.g. Lit Shader Mode, Shadow, SSAO if you use it). Disabling core rendering by mistake can make the scene dark or incomplete.
-
Quality and per-camera overrides
- If you use different HDRP assets per quality level, ensure they are all valid. If a camera has Custom Frame Settings override, ensure it doesn’t disable essential rendering.
Verification: With correct pipeline asset and frame settings, HDRP rendering matches what you expect (lit, shadows if enabled, no black screen).
Prevention Tips
- Start HDRP from a template (Unity Hub > New Project > HDRP template) so materials and scene are HDRP from the beginning.
- When importing assets, prefer HDRP-compatible packages or run the Built-in/URP to HDRP conversion and then fix remaining materials.
- Keep one Global Volume with Visual Environment (and optional exposure/fog) in every scene so lighting and sky are never missing.
When It Still Fails
- Pink after conversion: Some shaders (e.g. custom or third-party) have no HDRP equivalent. Replace with HDRP Lit/Unlit or contact the asset author for an HDRP version.
- Performance very bad: HDRP is heavy. Disable expensive features (e.g. some reflections, SSAO, or reduce resolution) in the HDRP asset or quality settings.
- Only one camera wrong: Check that camera’s HD Additional Camera Data and any Volume that affects it; override or priority might be wrong.
Related Help and Guides
- Unity Lighting Issues - How to Fix Dark Scenes for general lighting.
- Unity Post-Processing Not Working for effects in other pipelines.
- Unity URP Shadows Not Rendering for shadow issues (concepts apply to HDRP too).
For more on HDRP, see the Unity HDRP Documentation and our Unity guide on the site.
Bookmark this fix for quick reference when working with HDRP. If this article helped, share it with other developers using the High Definition Render Pipeline.