From 6ea4f6cda1953157fb02d098b54b0515238dda44 Mon Sep 17 00:00:00 2001
From: Fatimah Mohd Fauzi <fatimah.mohdfauzi@unity3d.com>
Date: Thu, 26 Feb 2026 08:15:25 +0000
Subject: [PATCH 1/2] DOCG-8438 Add BIRP deprecation notice

---
 com.unity.postprocessing/Documentation~/requirements.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/com.unity.postprocessing/Documentation~/requirements.md b/com.unity.postprocessing/Documentation~/requirements.md
index 664e64fa783..b9edebd8411 100644
--- a/com.unity.postprocessing/Documentation~/requirements.md
+++ b/com.unity.postprocessing/Documentation~/requirements.md
@@ -12,10 +12,13 @@ The **Post processing** package is compatible with the following versions of the
 
 This package is compatible with the following render pipeline versions:
 
-* Built-in render pipeline.
+* Built-In Render Pipeline.
 * Universal Render Pipeline (URP) 7.x, with Unity 2018 LTS, and 2019 LTS. Certain effects are not compatible with URP.
 * Scriptable Render Pipeline (SRP).
 
+> [!IMPORTANT]
+> In Unity 6.5 and newer, the Built-In Render Pipeline is deprecated and will be made obsolete in a future release. For more information, refer to [Migrating from the Built-In Render Pipeline to URP](https://docs.unity3d.com/6000.5/Documentation/Manual/urp/upgrading-from-birp.html) and [Render pipeline feature comparison](https://docs.unity3d.com/6000.5/Documentation/Manual/urp/upgrading-from-birp.html).
+
 ## Unity Player system requirements
 
 This package does not add any platform-specific requirements to Unity. For more information on Unity system requirements, see [System requirements for Unity](https://docs.unity3d.com/Manual/system-requirements.html).

From 39b63d3b33d28a4085a81b047c043fb863467683 Mon Sep 17 00:00:00 2001
From: Fatimah Mohd Fauzi <fatimah.mohdfauzi@unity3d.com>
Date: Tue, 17 Mar 2026 06:04:38 +0000
Subject: [PATCH 2/2] Update deprecation banner

---
 com.unity.postprocessing/Documentation~/Ambient-Occlusion.md | 2 ++
 com.unity.postprocessing/Documentation~/Anti-aliasing.md     | 2 ++
 com.unity.postprocessing/Documentation~/Auto-Exposure.md     | 2 ++
 com.unity.postprocessing/Documentation~/Bloom.md             | 2 ++
 .../Documentation~/Chromatic-Aberration.md                   | 2 ++
 com.unity.postprocessing/Documentation~/Color-Grading.md     | 2 ++
 .../Documentation~/Debugging-Post-processing-effects.md      | 2 ++
 com.unity.postprocessing/Documentation~/Deferred-Fog.md      | 2 ++
 com.unity.postprocessing/Documentation~/Depth-of-Field.md    | 2 ++
 com.unity.postprocessing/Documentation~/Grain.md             | 2 ++
 com.unity.postprocessing/Documentation~/Installation.md      | 2 ++
 com.unity.postprocessing/Documentation~/Lens-Distortion.md   | 2 ++
 .../Documentation~/Manipulating-the-Stack.md                 | 2 ++
 com.unity.postprocessing/Documentation~/Motion-Blur.md       | 2 ++
 com.unity.postprocessing/Documentation~/Quick-start.md       | 2 ++
 .../Documentation~/Screen-Space-Reflections.md               | 2 ++
 com.unity.postprocessing/Documentation~/Vignette.md          | 2 ++
 .../Documentation~/Writing-Custom-Effects.md                 | 2 ++
 com.unity.postprocessing/Documentation~/index.md             | 2 ++
 com.unity.postprocessing/Documentation~/known-issues.md      | 2 ++
 com.unity.postprocessing/Documentation~/requirements.md      | 5 ++---
 .../Documentation~/snippets/birp-deprecation-message.md      | 2 ++
 22 files changed, 44 insertions(+), 3 deletions(-)
 create mode 100644 com.unity.postprocessing/Documentation~/snippets/birp-deprecation-message.md

diff --git a/com.unity.postprocessing/Documentation~/Ambient-Occlusion.md b/com.unity.postprocessing/Documentation~/Ambient-Occlusion.md
index d14b59943f4..a497f0d3400 100644
--- a/com.unity.postprocessing/Documentation~/Ambient-Occlusion.md
+++ b/com.unity.postprocessing/Documentation~/Ambient-Occlusion.md
@@ -1,5 +1,7 @@
 # Ambient Occlusion
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Ambient Occlusion** effect calculates points in your scene that are exposed to ambient lighting. It then darkens areas that are hidden from the ambient light, such as creases, holes, and spaces between objects which are close together.
 
 You can achieve the **Ambient Occlusion** effect in two ways: in real-time as a full-screen post-processing effect, or as a baked lighting effect (see [Baked Ambient Occlusion](https://docs.unity3d.com/Manual/LightingBakedAmbientOcclusion.html)). The real-time **Ambient Occlusion** effect can be resource-intensive, which makes it better for desktop or console platforms. Its impact on processing time depends on screen resolution and effects properties.
diff --git a/com.unity.postprocessing/Documentation~/Anti-aliasing.md b/com.unity.postprocessing/Documentation~/Anti-aliasing.md
index ba710621647..84629f3a1bd 100644
--- a/com.unity.postprocessing/Documentation~/Anti-aliasing.md
+++ b/com.unity.postprocessing/Documentation~/Anti-aliasing.md
@@ -1,5 +1,7 @@
 # Anti-aliasing
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Anti-aliasing** effect softens the appearance of edges in your scene. To do this, it surrounds the edge with similar points of color. This reduces the jagged effect caused by [aliasing](https://en.wikipedia.org/wiki/Aliasing).
 
 ![Example of anti-aliasing smoothing the edges of shapes](images/screenshot-antialiasing.png)
diff --git a/com.unity.postprocessing/Documentation~/Auto-Exposure.md b/com.unity.postprocessing/Documentation~/Auto-Exposure.md
index 00d2f676b31..acfc597ca3e 100644
--- a/com.unity.postprocessing/Documentation~/Auto-Exposure.md
+++ b/com.unity.postprocessing/Documentation~/Auto-Exposure.md
@@ -1,5 +1,7 @@
 # Auto Exposure
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Auto Exposure** effect simulates how the human eye adjusts to changes in brightness in real-time. To do this, it dynamically adjusts the exposure of an image to match its mid-tone.
 
 In Unity, this effect generates a histogram on every frame and filters it to find the average luminance value. This histogram and the **Auto Exposure** effect requires [Compute shader](https://docs.unity3d.com/Manual/class-ComputeShader.html) support.
diff --git a/com.unity.postprocessing/Documentation~/Bloom.md b/com.unity.postprocessing/Documentation~/Bloom.md
index e07aef0eb18..627b77e4e57 100644
--- a/com.unity.postprocessing/Documentation~/Bloom.md
+++ b/com.unity.postprocessing/Documentation~/Bloom.md
@@ -1,5 +1,7 @@
 # Bloom
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Bloom** effect makes bright areas in your image glow. To do this, it creates fringes of light that extend from bright areas in your image. This simulates the effect a real-world camera gives when light overwhelms the lens.
 
 The Bloom effect also has a **Dirtiness** feature, which you can use to apply a full-screen layer of smudges or dust to diffract the Bloom effect.
diff --git a/com.unity.postprocessing/Documentation~/Chromatic-Aberration.md b/com.unity.postprocessing/Documentation~/Chromatic-Aberration.md
index 2a740bfb299..fe5e31b242d 100644
--- a/com.unity.postprocessing/Documentation~/Chromatic-Aberration.md
+++ b/com.unity.postprocessing/Documentation~/Chromatic-Aberration.md
@@ -1,5 +1,7 @@
 # Chromatic Aberration
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Chromatic Aberration** effect splits color along boundaries in an image into their red, green, and blue channels. This reproduces the effect a real-world camera produces when light refracts and causes the wavelengths to disperse in the lens.
 
 Unity provides support for red/blue and green/purple fringing. You can define fringing colors by using an input texture.
diff --git a/com.unity.postprocessing/Documentation~/Color-Grading.md b/com.unity.postprocessing/Documentation~/Color-Grading.md
index 542b8c08258..654ee6116b4 100644
--- a/com.unity.postprocessing/Documentation~/Color-Grading.md
+++ b/com.unity.postprocessing/Documentation~/Color-Grading.md
@@ -1,5 +1,7 @@
 # Color Grading
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Color Grading** effect alters or corrects the color and luminance of the final image that Unity produces. You can use this to alter the look and feel of your application.
 
 ![Three examples of how you can use Color Grading](images/screenshot-grading.png)
diff --git a/com.unity.postprocessing/Documentation~/Debugging-Post-processing-effects.md b/com.unity.postprocessing/Documentation~/Debugging-Post-processing-effects.md
index f0adc25cb35..bc0bcd153fe 100644
--- a/com.unity.postprocessing/Documentation~/Debugging-Post-processing-effects.md
+++ b/com.unity.postprocessing/Documentation~/Debugging-Post-processing-effects.md
@@ -1,5 +1,7 @@
 # Debugging Post-processing effects
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Post-process Debug** component displays real-time data about post-processing effects. You can use this data to debug your post-processing effects, and to see the results of adjusting your effects in real time.
 
 When you attach the Post-Process Debug component to a GameObject with a Camera component, the Post-Process Debug component displays its data on top of that Camera's output. You can use the Post-process Debug component in the Unity Editor, or when your application is running on a device.
diff --git a/com.unity.postprocessing/Documentation~/Deferred-Fog.md b/com.unity.postprocessing/Documentation~/Deferred-Fog.md
index 9c43d38e2bc..9cc1f4101dd 100644
--- a/com.unity.postprocessing/Documentation~/Deferred-Fog.md
+++ b/com.unity.postprocessing/Documentation~/Deferred-Fog.md
@@ -1,5 +1,7 @@
 # Deferred Fog
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Deferred Fog** effect simulates the look of fog or mist in outdoor environments. To do this, it overlays a color onto objects depending on how far away they are from the Camera.
 
  ![Scene rendered with Deferred Fog enabled](images/screenshot-fog.png)
diff --git a/com.unity.postprocessing/Documentation~/Depth-of-Field.md b/com.unity.postprocessing/Documentation~/Depth-of-Field.md
index d458213444f..23da185e97f 100644
--- a/com.unity.postprocessing/Documentation~/Depth-of-Field.md
+++ b/com.unity.postprocessing/Documentation~/Depth-of-Field.md
@@ -1,5 +1,7 @@
 # Depth of Field
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Depth of Field** effect blurs the background of your image while the objects in the foreground stay in focus. This simulates the focal properties of a real-world camera lens.
 
  ![A scene with the Depth of Field effect applied](images/screenshot-dof.png)
diff --git a/com.unity.postprocessing/Documentation~/Grain.md b/com.unity.postprocessing/Documentation~/Grain.md
index 07aa8d6c9e8..a20d125304a 100644
--- a/com.unity.postprocessing/Documentation~/Grain.md
+++ b/com.unity.postprocessing/Documentation~/Grain.md
@@ -1,5 +1,7 @@
 # Grain
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Grain** effect overlays film noise onto your image. Film noise is the effect that real-world cameras produce when small particles in the camera’s film give the image a coarse, unprocessed effect.
 Unity’s **Grain** effect is based on a coherent gradient noise. This gives your game a gritty effect that simulates the imperfections of film.
 
diff --git a/com.unity.postprocessing/Documentation~/Installation.md b/com.unity.postprocessing/Documentation~/Installation.md
index d49587b116a..53baf697cea 100644
--- a/com.unity.postprocessing/Documentation~/Installation.md
+++ b/com.unity.postprocessing/Documentation~/Installation.md
@@ -1,5 +1,7 @@
 # Installation
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 Use the [**Package Manager**](https://docs.unity3d.com/Manual/upm-ui.html) to install the **Post Processing** package or to update an installed package to the latest version.
 
 To install the **Post Processing** package:
diff --git a/com.unity.postprocessing/Documentation~/Lens-Distortion.md b/com.unity.postprocessing/Documentation~/Lens-Distortion.md
index bc191f0a1ec..aee673ad827 100644
--- a/com.unity.postprocessing/Documentation~/Lens-Distortion.md
+++ b/com.unity.postprocessing/Documentation~/Lens-Distortion.md
@@ -1,5 +1,7 @@
 # Lens Distortion
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Lens Distortion** effect simulates distortion caused by the shape of a real-world camera lens. You can adjust the intensity of this effect between barrel distortion and pincushion distortion.
 
 ![Scene without Lens Distortion effect](images/no-lens-distortion.png)
diff --git a/com.unity.postprocessing/Documentation~/Manipulating-the-Stack.md b/com.unity.postprocessing/Documentation~/Manipulating-the-Stack.md
index 28cdad8565e..5aba430f56b 100644
--- a/com.unity.postprocessing/Documentation~/Manipulating-the-Stack.md
+++ b/com.unity.postprocessing/Documentation~/Manipulating-the-Stack.md
@@ -1,5 +1,7 @@
 # Controlling effects using scripts
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 This guide explains how to modify a post-processing script to create time-based events or temporary post-processing effects.
 
 ## Quick Volumes
diff --git a/com.unity.postprocessing/Documentation~/Motion-Blur.md b/com.unity.postprocessing/Documentation~/Motion-Blur.md
index 291287dcf43..78c9ff0dd64 100644
--- a/com.unity.postprocessing/Documentation~/Motion-Blur.md
+++ b/com.unity.postprocessing/Documentation~/Motion-Blur.md
@@ -1,5 +1,7 @@
 # Motion Blur
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Motion Blur** effect blurs the image in the direction of the **Camera’s** movement. This simulates the blur effect a real-world camera creates when it moves with the lens aperture open, or when it captures an object moving faster than the camera’s exposure time.
 
 ![Scene using the Motion Blur effect](images/screenshot-motionblur.png)
diff --git a/com.unity.postprocessing/Documentation~/Quick-start.md b/com.unity.postprocessing/Documentation~/Quick-start.md
index 66345aa9529..fca1a2ed88b 100644
--- a/com.unity.postprocessing/Documentation~/Quick-start.md
+++ b/com.unity.postprocessing/Documentation~/Quick-start.md
@@ -1,5 +1,7 @@
 # Getting started with post-processing
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 This page explains how to set up the components required to create post-processing effects in your scene.
 
 <a name="post-process-layer"></a>
diff --git a/com.unity.postprocessing/Documentation~/Screen-Space-Reflections.md b/com.unity.postprocessing/Documentation~/Screen-Space-Reflections.md
index 90ca2e3bb3d..da086ae8d63 100644
--- a/com.unity.postprocessing/Documentation~/Screen-Space-Reflections.md
+++ b/com.unity.postprocessing/Documentation~/Screen-Space-Reflections.md
@@ -1,5 +1,7 @@
 # Screen Space Reflections
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Screen Space Reflection** effect creates subtle reflections that simulate wet floor surfaces or puddles. It reflects both static and dynamic GameObjects to create realistic reflections.
 
 Screen Space Reflection replaces specular highlights on a surface, which makes it an ideal effect to limit the amount of [specular light](https://docs.unity3d.com/Manual/shader-NormalSpecular.html) leaking.
diff --git a/com.unity.postprocessing/Documentation~/Vignette.md b/com.unity.postprocessing/Documentation~/Vignette.md
index 57eb02f4b9c..60944e63bbd 100644
--- a/com.unity.postprocessing/Documentation~/Vignette.md
+++ b/com.unity.postprocessing/Documentation~/Vignette.md
@@ -1,5 +1,7 @@
 # Vignette
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 The **Vignette** effect darkens the edges of an image. This simulates the effect in a real-world camera lens caused by thick or stacked filters, secondary lenses, or an improper lens hood. You can use the **Vignette** effect to draw attention to the center of an image.
 
 ![Scene without Vignette](images/PostProcessing-Vignette-1.png)
diff --git a/com.unity.postprocessing/Documentation~/Writing-Custom-Effects.md b/com.unity.postprocessing/Documentation~/Writing-Custom-Effects.md
index 62b830d33f4..8f6eb713abe 100644
--- a/com.unity.postprocessing/Documentation~/Writing-Custom-Effects.md
+++ b/com.unity.postprocessing/Documentation~/Writing-Custom-Effects.md
@@ -1,5 +1,7 @@
 # Writing custom effects
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 This quick-start guide demonstrates how to write a custom [post-processing effect](https://docs.unity3d.com/Manual/PostProcessingOverview.html) and include it in the post-processing stack. This process does not require you to modify the codebase.
 
 Custom post-processing effects require a minimum of two files:
diff --git a/com.unity.postprocessing/Documentation~/index.md b/com.unity.postprocessing/Documentation~/index.md
index f8268453d7b..267ce770fc1 100644
--- a/com.unity.postprocessing/Documentation~/index.md
+++ b/com.unity.postprocessing/Documentation~/index.md
@@ -1,5 +1,7 @@
 ## Post Processing Stack v2 overview
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 Post-processing is a generic term for a full-screen image processing effect that occurs after the camera draws the scene but before the scene is rendered on the screen. Post-processing can drastically improve the visuals of your product with little setup time.
 
 You can use post-processing effects to simulate physical camera and film properties.
diff --git a/com.unity.postprocessing/Documentation~/known-issues.md b/com.unity.postprocessing/Documentation~/known-issues.md
index d158d085b32..90261307264 100644
--- a/com.unity.postprocessing/Documentation~/known-issues.md
+++ b/com.unity.postprocessing/Documentation~/known-issues.md
@@ -1,5 +1,7 @@
 # Known issues
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 - The **Post Processing** package doesn't work on MacOS X 10.11.6 when running Metal in the editor due to a driver bug on this specific version of the OS.
 
 For limitations and known issues for each effect, see the specific effect page.
diff --git a/com.unity.postprocessing/Documentation~/requirements.md b/com.unity.postprocessing/Documentation~/requirements.md
index b9edebd8411..a7c42d44256 100644
--- a/com.unity.postprocessing/Documentation~/requirements.md
+++ b/com.unity.postprocessing/Documentation~/requirements.md
@@ -1,5 +1,7 @@
 # Requirements and compatibility
 
+[!include[birp-deprecation-message](snippets/birp-deprecation-message.md)]
+
 This page contains information on system requirements and compatibility of this Post-processing module.
 
 ## Unity Editor compatibility
@@ -16,9 +18,6 @@ This package is compatible with the following render pipeline versions:
 * Universal Render Pipeline (URP) 7.x, with Unity 2018 LTS, and 2019 LTS. Certain effects are not compatible with URP.
 * Scriptable Render Pipeline (SRP).
 
-> [!IMPORTANT]
-> In Unity 6.5 and newer, the Built-In Render Pipeline is deprecated and will be made obsolete in a future release. For more information, refer to [Migrating from the Built-In Render Pipeline to URP](https://docs.unity3d.com/6000.5/Documentation/Manual/urp/upgrading-from-birp.html) and [Render pipeline feature comparison](https://docs.unity3d.com/6000.5/Documentation/Manual/urp/upgrading-from-birp.html).
-
 ## Unity Player system requirements
 
 This package does not add any platform-specific requirements to Unity. For more information on Unity system requirements, see [System requirements for Unity](https://docs.unity3d.com/Manual/system-requirements.html).
diff --git a/com.unity.postprocessing/Documentation~/snippets/birp-deprecation-message.md b/com.unity.postprocessing/Documentation~/snippets/birp-deprecation-message.md
new file mode 100644
index 00000000000..d2a0533774f
--- /dev/null
+++ b/com.unity.postprocessing/Documentation~/snippets/birp-deprecation-message.md
@@ -0,0 +1,2 @@
+> [!IMPORTANT]
+> In Unity 6.5 and newer, Post Processing Stack v2 is deprecated now that the Built-In Render Pipeline is deprecated and will be made obsolete in a future release.<br/>The Built-In Render Pipeline remains supported, including bug fixes and maintenance, through the full Unity 6.7 LTS lifecycle.<br/>For more information on migration, refer to [Migrating from the Built-In Render Pipeline to URP](https://docs.unity3d.com/6000.5/Documentation/Manual/urp/upgrading-from-birp.html) and [Render pipeline feature comparison](https://docs.unity3d.com/6000.5/Documentation/Manual/render-pipelines-feature-comparison.html).