# ShaderBuildSettings.KeywordDeclarationOverride

> Shader build settings data element to override keyword declarations.

## Definition

* **Type:** Struct
* **Namespace:** [UnityEditor.Shaders](/engine/6000.7/script-reference/unityeditor/shaders.md)
* **Assembly:** UnityEditor.CoreModule

```csharp
public struct ShaderBuildSettings.KeywordDeclarationOverride
```

## Remarks

A `KeywordDeclarationOverride` struct contains data that either disables or enables the keywords in a set, overrides the keyword type of a set of keywords, or strips the keywords from the build.

Additional Resources: [ShaderBuildSettings](/engine/6000.7/script-reference/unityeditor/shaders/shaderbuildsettings.md).

## Examples

```csharp
using System;
using System.Collections.Generic;
using UnityEditor.Rendering;
using UnityEditor.Shaders;
using UnityEngine;

using KeywordDeclarationOverride = UnityEditor.Shaders.ShaderBuildSettings.KeywordDeclarationOverride;
using KeywordOverrideInfo = UnityEditor.Shaders.ShaderBuildSettings.KeywordOverrideInfo;

public class ShaderBuildSettingsExample
{
    void AddKeywordDeclarationOverride()
    {
        // Get current shader build settings either from the currently active build profile
        // or if none is active, the global graphics settings.
        ShaderBuildSettings buildSettings = EditorGraphicsSettings.GetShaderBuildSettings();

        // Create a new keyword declaration override
        var newOverride = new KeywordDeclarationOverride
        {
            // Define the set of keywords to override
            keywords = new KeywordOverrideInfo[] { new("_", true), new("LINEAR_BEAUTY", true), new("EXPONENTIAL_BEAUTY", true) },

            // Use dynamic branching. Note: The shader import fails if the shader code isn't compatible with dynamic branching.
            variantGenerationMode = ShaderBuildSettings.ShaderVariantGenerationMode.SingleVariantWithDynamicBranching
        };

        // Check if each keyword is valid
        foreach (var kw in newOverride.keywords)
        {
            Debug.Log(kw.name + (kw.keepInBuild ? ": keep" : ": strip"));
            if (!kw.IsValid())
                return;
        }

        // Check if an override is valid.
        string validationErrors;
        if (!newOverride.IsValid(out validationErrors))
        {
            Debug.LogError(validationErrors);
            return;
        }

        // Get the copy of the existing overrides, and add the new overrides struct
        var kwDeclarationOverrides = new List<KeywordDeclarationOverride>(buildSettings.GetKeywordDeclarationOverridesCopy());
        kwDeclarationOverrides.Add(newOverride);

        // Set the modified keyword declaration overrides on the settings data struct. Throw an exception if the data is invalid.
        try
        {
            buildSettings.KeywordDeclarationOverrides = kwDeclarationOverrides.ToArray();
        }
        catch (ArgumentException ex)
        {
            Debug.LogError(ex.Message);
            return;
        }

        // Apply the modified settings data back to the Graphics settings or Build Profile settings
        EditorGraphicsSettings.SetShaderBuildSettings(buildSettings);
    }
}
```

## Fields

| Value                                                                                                                                                | Description                                                |
| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [keywords](/engine/6000.7/script-reference/unityeditor/shaders/shaderbuildsettings/keyworddeclarationoverride/keywords.md)                           | An array of keywords defining the target of this override. |
| [variantGenerationMode](/engine/6000.7/script-reference/unityeditor/shaders/shaderbuildsettings/keyworddeclarationoverride/variantgenerationmode.md) | The variant generation mode override.                      |

## Constructors

| Constructor                                                                                                                                | Description                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| [KeywordDeclarationOverride()](/engine/6000.7/script-reference/unityeditor/shaders/shaderbuildsettings/keyworddeclarationoverride/ctor.md) | Creates a new settings element representing a shader keyword declaration override. |

## Methods

| Method                                                                                                                   | Description                                      |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------ |
| [IsValid](/engine/6000.7/script-reference/unityeditor/shaders/shaderbuildsettings/keyworddeclarationoverride/isvalid.md) | Validates the keyword declaration override data. |