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
- Replace with PlayerSettings.WSA.SetVisualAssetsImage(path, WSAImageType.UWPSquare150x150Logo, WSAImageScale._100).
- Migrate all storeLargeTile* variants (base, 80, 140, 180) at the same time.
- 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
- Replace storeLargeTile assignments with SetVisualAssetsImage.
- Maintain a migration mapping table for all deprecated WSA properties when upgrading Unity.
- Pin plugin versions to those compatible with the target Unity version.
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
- PlayerSettings.storeSmallTile180 is deprecated. Use SetVisua
- PlayerSettings.storeLargeTile80 is deprecated. Use GetVisual
- PlayerSettings.storeLargeTile80 is deprecated. Use SetVisual
- PlayerSettings.storeLargeTile is deprecated. Use GetVisualAs
- PlayerSettings.storeLargeTile140 is deprecated. Use GetVisua
AI-assisted analysis of Unity-Technologies/UnityCsReference@225b0fbdb5 (2026-08-13).
Data as JSON: /api/errors/e8f9f86dab0e012f.
Report an issue: GitHub.