Update deprecation banner

fatimah-mf-unity · fatimah-mf-unity · commit 39b63d3b33d2 · 2026-03-17T06:04:38.000Z
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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).
