Unity-Technologies/UnityCsReference · error · NotSupportedException

PlayerSettings.storeSmallTile is deprecated. Use GetVisualAs

Error message

PlayerSettings.storeSmallTile is deprecated. Use GetVisualAssetsImage() instead.

What it means

PlayerSettings.WSA.storeSmallTile is a deprecated property representing the small 71x71 square tile image shown on the Start menu at 100% base scale. It is decorated with [Obsolete("Use GetVisualAssetsImage()/SetVisualAssetsImage()", true)], making direct access a compile-time error (CS0619). The get accessor additionally throws NotSupportedException at runtime to catch reflection-based or dynamically dispatched access. The replacement API is GetVisualAssetsImage(WSAImageType.UWPSquare71x71Logo, WSAImageScale._100) for this specific accessor.

Source

Thrown at Editor/Mono/PlayerSettingsWSA.cs:359

            public static string storeSmallTile80
            {
                get
                {
                    throw new NotSupportedException("PlayerSettings.storeSmallTile80 is deprecated. Use GetVisualAssetsImage() instead.");
                }
                set
                {
                    throw new NotSupportedException("PlayerSettings.storeSmallTile80 is deprecated. Use SetVisualAssetsImage() instead.");
                }
            }

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

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

View on GitHub (pinned to 225b0fbdb5)

Solutions

  1. Replace the property read with PlayerSettings.WSA.GetVisualAssetsImage(WSAImageType.UWPSquare71x71Logo, WSAImageScale._100).
  2. If the 100% scale is deprecated (80/140/180), switch to a UWP-supported scale such as WSAImageScale._100 or WSAImageScale._200.
  3. If the calling code is in a shared library, wrap the new call in a #if UNITY_2019_4_OR_NEWER (or appropriate version) preprocessor guard to maintain backward compatibility.
  4. Search the entire solution for all references to the deprecated property (including in .asmdef-referenced assemblies) to ensure no compile-time or reflection-based access remains.

Example fix

// before
var logoPath = PlayerSettings.WSA.storeSmallTile;
// after
var logoPath = PlayerSettings.WSA.GetVisualAssetsImage(
    WSAImageType.UWPSquare71x71Logo,
    WSAImageScale._100);
Defensive patterns

Strategy: validation

Validate before calling

// Validate the property is not among the deprecated set before reflection access
var prop = typeof(PlayerSettings.WSA).GetProperty("storeSmallTile");
if (prop != null && prop.GetCustomAttribute<ObsoleteAttribute>()?.IsError == true)
{
    // Use the replacement API instead
    var img = PlayerSettings.WSA.GetVisualAssetsImage(
        WSAImageType.UWPSquare71x71Logo, WSAImageScale._100);
}

Try / catch

try
{
    // Deprecated property access via reflection
    var val = typeof(PlayerSettings.WSA)
        .GetProperty("storeSmallTile")?.GetValue(null);
}
catch (NotSupportedException ex) when (ex.Message.Contains("deprecated"))
{
    // Fallback to the replacement API
    var val = PlayerSettings.WSA.GetVisualAssetsImage(
        WSAImageType.UWPSquare71x71Logo, WSAImageScale._100);
}

Prevention

When it happens

Trigger: Accessing PlayerSettings.WSA.storeSmallTile via its get accessor. Reading the property value, e.g. var img = PlayerSettings.WSA.storeSmallTile; triggers the NotSupportedException from the get block. Compile-time access is blocked by the [Obsolete(..., true)] attribute (error CS0619). Runtime exceptions only surface when the property is reached through reflection, dynamic invocation, or IL that bypasses the compiler check.

Common situations: Upgrading a Unity project from a version that supported these Windows 8.1-era store image properties to a UWP-only build. Build scripts, CI/CD pipelines, or editor extensions that batch-configure WSA visual assets using the old individual-property API. Third-party plugins or asset store packages that reference PlayerSettings.WSA.storeSmallTile. Code migrated from Windows 8.1 Metro/WinRT templates that hardcoded DPI-scaled tile logos.

Related errors


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