Version: Unity 6 Preview (6000.0)
Language : English
Package samples reference for URP
Upgrading from the Built-In Render Pipeline to URP

Install URP into an existing project

If you have started a Project using the Built-in Render PipelineA series of operations that take the contents of a Scene, and displays them on a screen. Unity lets you choose from pre-built render pipelines, or write your own. More info
See in Glossary
, you can install URP and configure your Project to use URP. When you do this, you must configure URP yourself. You will need to manually convert or recreate parts of your Project (such as lit shaders or post-processing effects) to be compatible with URP.

You can download and install the latest version of the Universal Render Pipeline (URP) to your existing Project via the Package Manager system, and then install it into your Project. If you don’t have an existing Project, refer to documentation on how to start a new URP Project from a Template.

Before you begin

URP uses its own integrated post-processing solution. If you have the Post Processing Version 2 package installed in your Project, you need to delete the Post Processing Version 2 package before you install URP into your Project. When you have installed URP, you can then recreate your post-processingA process that improves product visuals by applying filters and effects before the image appears on screen. You can use post-processing effects to simulate physical camera and film properties, for example Bloom and Depth of Field. More info post processing, postprocessing, postprocess
See in Glossary
effects.

URP does not currently support custom post-processing effects. If your Project uses custom post-processing effects, these cannot currently be recreated in URP. Custom post-processing effects will be supported in a forthcoming release of URP.

Projects made using URP are not compatible with the High Definition Render Pipeline (HDRP) or the Built-in Render Pipeline. Before you start development, you must decide which render pipeline to use in your Project. For information on choosing a render pipeline, refer to the Render Pipelines section of the Unity Manual.

Installing URP

  1. In Unity, open your Project.
  2. In the top navigation bar, select Window > Package Manager to open the Package Manager window.
  3. In the Packages menu, select Unity Registry. This shows the list of available packages for the version of Unity that you are currently running.
  4. Select Universal RP from the list of packages.
  5. In the bottom right corner of the Package Manager window, select Install. Unity installs URP directly into your Project.

Configuring URP

Before you can start using URP, you need to configure it. To do this, you need to create a Scriptable Render Pipeline Asset and adjust your Graphics settings.

Creating the Universal Render Pipeline Asset

The Universal Render Pipeline Asset (URP Asset) contains the global rendering and quality settings of your project, and creates the rendering pipeline instance. The rendering pipeline instance contains intermediate resources and the render pipeline implementation.

To create a Universal Render Pipeline Asset:

  1. In the Editor, go to the Project windowA window that shows the contents of your Assets folder (Project tab) More info
    See in Glossary
    .
  2. Right-click in the Project window, and select Create > Rendering > URP Asset (with Universal Renderer). Alternatively, navigate to the menu bar at the top, and select Assets > Create > Rendering > URP Asset (with Universal Renderer).

You can either leave the default name for the new Universal Render Pipeline Asset, or type a new one.

Set URP as the active render pipeline

To set URP as the active render pipeline:

  1. In your project, locate the Render Pipeline Asset that you want to use.
    Tip: to find all URP Assets in a project, use the following query in the search field: t:universalrenderpipelineasset.

  2. Select Edit > Project Settings > Graphics.

  3. In the Scriptable Render Pipeline Settings field, select the URP Asset. When you select the URP Asset, the available Graphics settings change immediately.

Optional:

Set an override URP Assets for different quality levels:

  1. Select Edit > Project Settings > Quality.

  2. Select a quality level. In the Render Pipeline Asset field, select the Render Pipeline Asset.

Upgrading your shaders

If your project uses the prebuilt Standard Shader, or custom Unity shadersA program that runs on the GPU. More info
See in Glossary
made for the Built-in Render Pipeline, you must convert them to URP-compatible Unity shaders. For more information on this topic, refer to Upgrading your Shaders.

Upgrade from the Built-in Render Pipeline

When you upgrade a project from the Built-in Render Pipeline (BiRP) to the Universal Render Pipeline (URP), there are many changes which occur. These changes are wide reaching and require some work beyond the initial installation process for URP shown here. The following pages explain more about these changes and provide guidance on any additional steps required:

Package samples reference for URP
Upgrading from the Built-In Render Pipeline to URP