Version: Unity 6.7 Alpha (6000.7)
Language : English
Set a shader to require GPU features
Compute shaders

Set the graphics API or platform for a shader

By default, Unity compiles all shader programs for each graphics API in the list for the current build target. To compile certain shader programs only for certain graphics APIs or platforms, for example if you use features that aren’t supported on all platforms, use a #pragma statement.

Use one of the following in the HLSLPROGRAM block of a shader:

  • #pragma only_renderers to compile shaders only for a specific graphics API, for example #pragma only_renderers metal.
  • #pragma exclude_renderers to exclude shaders from compilation for a specific graphics API, for example #pragma exclude_renderers metal.

You can pass multiple values by adding a space between each argument, for example #pragma only_renderers metal vulkan.

The supported values are:

Value Description
d3d11 DirectX 11 feature level 10 and above, and DirectX 12. This value is provided for compatibility reasons. In a new project, use dx11 and dx12 instead.
dx11 DirectX 11 feature level 10 and above.
dx12 DirectX 12.
glcore OpenGL 3.x, OpenGL 4.x
gles3 OpenGL ES 3.x, WebGL 2.0
metal Metal on iOS or macOS
ps4 PlayStation®4
ps5 PlayStation®5
playstation PlayStation®4 or PlayStation®5
switch Nintendo Switch™
vulkan Vulkan
webgpu WebGPU
xboxseries Xbox Series S|X

Additional resources

Set a shader to require GPU features
Compute shaders