Unity-Technologies/UnityCsReference · error · NotSupportedException

PlayerSettings.storeLargeTile is deprecated. Use SetVisualAs

Error message

PlayerSettings.storeLargeTile is deprecated. Use SetVisualAssetsImage() instead.

What it means

PlayerSettings.WSA.storeLargeTile is a deprecated static property setter that always throws NotSupportedException. The base-scale (100%) large tile image setter was superseded by SetVisualAssetsImage(string, WSAImageType, WSAImageScale). Marked [Obsolete(..., true)] and [EditorBrowsable(Never)].

Source

Thrown at Editor/Mono/PlayerSettingsWSA.cs:419

                    throw new NotSupportedException("PlayerSettings.storeLargeTile80 is deprecated. Use GetVisualAssetsImage() instead.");
                }
                set
                {
                    throw new NotSupportedException("PlayerSettings.storeLargeTile80 is deprecated. Use SetVisualAssetsImage() instead.");
                }
            }

            [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
            [Obsolete("Use GetVisualAssetsImage()/SetVisualAssetsImage()", true)]
            public static string storeLargeTile
            {
                get
                {
                    throw new NotSupportedException("PlayerSettings.storeLargeTile is deprecated. Use GetVisualAssetsImage() instead.");
                }
                set
                {
                    throw new NotSupportedException("PlayerSettings.storeLargeTile is deprecated. Use SetVisualAssetsImage() instead.");
                }
            }

            [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
            [Obsolete("Use GetVisualAssetsImage()/SetVisualAssetsImage()", true)]
            public static string storeLargeTile140
            {
                get
                {
                    throw new NotSupportedException("PlayerSettings.storeLargeTile140 is deprecated. Use GetVisualAssetsImage() instead.");
                }
                set
                {
                    throw new NotSupportedException("PlayerSettings.storeLargeTile140 is deprecated. Use SetVisualAssetsImage() instead.");
                }
            }

            [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]

View on GitHub (pinned to 225b0fbdb5)

Solutions

  1. Replace with PlayerSettings.WSA.SetVisualAssetsImage(path, WSAImageType.UWPSquare150x150Logo, WSAImageScale._100).
  2. Migrate all storeLargeTile* variants (base, 80, 140, 180) at the same time.
  3. Replace or update plugins that still reference the deprecated setter.

Example fix

// before
PlayerSettings.WSA.storeLargeTile = "Assets/Icons/largeTile.png";

// after
PlayerSettings.WSA.SetVisualAssetsImage("Assets/Icons/largeTile.png", WSAImageType.UWPSquare150x150Logo, WSAImageScale._100);
Defensive patterns

Strategy: type-guard

Validate before calling

// Use the new setter API for base scale
PlayerSettings.WSA.SetVisualAssetsImage(path, WSAImageType.UWPSquare150x150Logo, WSAImageScale._100);

Type guard

static bool IsDeprecatedWsaProperty(string name) =>
    typeof(PlayerSettings.WSA)
        .GetProperty(name,
            System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.Static)
        ?.GetCustomAttribute<ObsoleteAttribute>()?.IsError == true;

Prevention

When it happens

Trigger: Assigning to PlayerSettings.WSA.storeLargeTile (the setter) in editor scripts or build automation. Hit most often via reflection-based serialization or code targeting an older Unity API.

Common situations: Migrating a UWP build pipeline from Unity 5.x/2017 to a newer version; CI scripts that set tile images; third-party packages with stale references.

Related errors


AI-assisted analysis of Unity-Technologies/UnityCsReference@225b0fbdb5 (2026-08-13). Data as JSON: /api/errors/e8f9f86dab0e012f. Report an issue: GitHub.