Version: Unity 6.5 Alpha (6000.5)
Language : English
HDRP to URP migration workflow
Convert shaders from HDRP to URP

Set up your HDRP project to use URP

To migrate an existing High Definition 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
(HDRP) project to use the Universal Render Pipeline (URP) instead, you must first install and configure URP.

For more information on the different render pipelines, refer to Choose a render pipeline and Render pipeline feature comparison reference.

If you don’t have an existing HDRP project, refer to Create a new project that uses URP.

To set up your project to use URP, do the following:

  1. Optional: Duplicate your HDRP project.
  2. Install URP.
  3. Configure URP.

Duplicate your HDRP project

  1. Duplicate your existing HDRP project.
  2. Rename the duplicated project to clearly differentiate it as the project you’re migrating to URP.

Keep both separate projects open during the migration process.

Tip: You can use branches to manage your project.

Install URP

  1. In Unity, open the project you’re migrating to URP.
  2. From the main menu, select Window > Package Management > Package Manager to open the Package Manager window.
  3. Go to Sources > Unity Registry. This shows the list of available packages for the version of Unity that you’re currently running.
  4. Select Universal Render Pipeline from the list of packages.
  5. Select Install. Unity installs URP directly into your project.

Keep both the URP and HDRP packages installed in your project during the migration process.

Configure URP

Before you can start using URP, you need to configure it to work in your project. To do this, in your new URP project, do the following:

  1. Create URP assets.
  2. Configure URP assets.
  3. Set URP as the active render pipeline.

Create URP assets

Create a URP asset and Universal Renderer asset for each HDRP asset in your project. To create these assets, refer to Create a Universal Render Pipeline asset.

Configure URP assets

Configure the settings in each URP asset and Universal Renderer asset to correspond to the settings in your HDRP assets. For more information on each setting in URP, refer to URP asset reference and Universal Renderer asset reference.

Many settings in HDRP aren’t identical or supported in URP. To find some of the corresponding settings, refer to HDRP quality settings in URP reference.

Set URP as the active render pipeline

To set URP as the active render pipeline:

  1. Locate the URP 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. Go to Edit > Project Settings > Graphics.
  3. In the Set Default Render Pipeline Asset section, set Default Render Pipeline to the URP asset. When you select the URP asset, the available Graphics settings change immediately.

To optionally set a different URP asset for each quality level, follow these steps:

  1. Select Edit > Project Settings > Quality.
  2. Select a quality level.
  3. In the Render Pipeline Asset field, select the URP asset.

Additional resources

HDRP to URP migration workflow
Convert shaders from HDRP to URP