docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Shaders view reference

    The Shaders view displays information related to the shaders in your project and how they impact the performance of your project. You can select from the following views:

    • Shaders
    • Shader Variants
    • Compiler Messages
    • Materials

    Shaders view


    Project Auditor window with the Shaders view open

    The table of issues has the following columns. Use the table controls to configure how to organize and display the data.

    Property Description
    Shader Name The shader name, as declared inside the .shader file itself. For the actual asset file name, refer to the Path column.
    Size The file size of the shader, as reported in the most recent build report. Shaders that weren't included in the build are reported as being 0 bytes in size.
    Num Variants Number of potential shader variants for a single stage (for example: fragment), per rendering platform API (for example: Vulkan). This is the raw number of variants from considering keyword combinations, and contributes to build times and sizes. The build process might strip these variants down to a smaller number of variants that are actually included in the build.
    Built Fragment Variants Number of fragment shader variants per rendering platform API (for example: Vulkan) that were actually included in the build.
    Num Passes The number of passes included in this shader.
    Num Keywords The number of keywords referenced in this shader, including both globally keywords and local keywords declared in #pragma statements in this shader.
    Num Properties The number of properties in this shader.
    Num Tex Properties The number of properties in this shader which can hold a texture object.
    Render Queue The shader's render queue, which determines the order in which objects are rendered
    Instancing Displays a tick if any of this shader's passes enable GPU Instancing. Refer to Creating shaders that support GPU instancing for more information.
    SRP Batcher Displays a tick if this shader is compatible with the Scriptable Render Pipeline batcher.
    Always Included Displays a tick if this shader is on the list of Always Included Shaders in the Graphics settings.
    Path The full path and file name of the source shader asset.

    Shader Variants View

    Displays all shader variants included in the build. Built-in shaders are included only after building the project for the target platform.

    To populate the data in the table, build your project and then select the Refresh button (⟳).


    Project Auditor window with the Shader Variants view open

    Runtime shader compilation

    To also view which Shader Variants were requested and compiled at runtime:

    • Go to Settings > Graphics > Shader Preloading and enable Log Shader Compilation
    • Ensure that the build you create is a Development build
    • Run the build on the target platform. Be sure to test every scene and view in the build if you want to generate a complete list of compiled variants.
    • Stop running the build, and locate the Player.log file. Drag this file onto the Shader Variants View.

    Project Auditor then parses the compilation log and populates the Compiled column.

    Issue table

    The table of issues has the following columns. Use the table controls to configure how to organize and display the data.

    Property Description
    Shader Name The name of the shader that includes this shader variant.
    Compiled Shows a tick if this shader variant was compiled and used at runtime, as reported in a player log.
    Graphics API The graphics API which this shader variant targets.
    Tier In the Built-in Render Pipeline, indicates the hardware tier that this shader variant targets. Refer to Graphics tiers and shader variants for more information.
    Stage The stage in the rendering pipeline in which this shader variant runs. Refer to the ShaderType API documentation for a full list of stages.
    Pass Type The shader pass type in which this shader variant runs.Refer to the PassType API documentation for more information.
    Pass Name The name of the shader pass in which this shader variant runs.
    Keywords A list of all the shader keywords that represent this specific shader variant. See the selected item detail panel to the right for an alternative view of this keyword list.
    Platform Keywords A list of all the BuiltInShaderDefine keywords set by the Editor for this shader variant. Refer to the selected item detail panel to the right for an alternative view of this keyword list.
    Requirements A list of all the ShaderRequirements features required by this shader variant. Refer to the selected item detail panel to the right for an alternative view of this requirement list.

    Compiler Messages view

    Displays shader compiler error and warning messages encountered during the build process.

    The table of issues has the following columns. Use the table controls to configure how to organize and display the data.

    Property Description
    Log Level The log level of the compiler message (Error/Warning).
    Message The error/warning message string reported by the compiler. If you select a report item in the table, this message is displayed in the selected item detail panel to the right.
    Shader Name The name of the shader that generated the message. Double-click on any report item to automatically open the shader file or in a Shadergraph window.
    Platform The graphics API targeted by the shader.
    Path The full path and filename of the source shader asset that generated the message.

    Materials view

    Displays all material assets in the project's Assets folder, along with their properties and asset import settings.

    Tip

    Enable the Show/Hide hierarchy button select Group By: Shader to easily see all of the materials that reference a particular shader.

    The table of issues has the following columns. Use the table controls to configure how to organize and display the data.

    Property Description
    Material Name The material file name.
    Shader The name of the shader referenced by this material.
    Source Asset The full path to the source material asset within the Assets folder.

    Additional resources

    • Analyze your project
    • Project Auditor window reference overview

    Did you find this page useful? Please give it a rating:

    Thanks for rating this page!

    Report a problem on this page

    What kind of problem would you like to report?

    • This page needs code samples
    • Code samples do not work
    • Information is missing
    • Information is incorrect
    • Information is unclear or confusing
    • There is a spelling/grammar error on this page
    • Something else

    Thanks for letting us know! This page has been marked for review based on your feedback.

    If you have time, you can provide more information to help us fix the problem faster.

    Provide more information

    You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:

    You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:

    You've told us there is information missing from this page. Please tell us more about what's missing:

    You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:

    You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:

    You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:

    You've told us this page has a problem. Please tell us more about what's wrong:

    Thank you for helping to make the Unity documentation better!

    Your feedback has been submitted as a ticket for our documentation team to review.

    We are not able to reply to every ticket submitted.

    In This Article
    • Shaders view
    • Shader Variants View
      • Runtime shader compilation
      • Issue table
    • Compiler Messages view
    • Materials view
    • Additional resources
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)