Migrating to 2026 April

Introduction

This page discusses breaking changes and other considerations when migrating from 2026 March to 2026 April.

Upgrading Gum Tool

The 2026 April release of the Gum tool is not yet available. This page will be updated with download links when the release is published.

Upgrading Runtime

The 2026 April NuGet packages are not yet available. This page will be updated with version numbers when the packages are published.

See below for breaking changes and updates.

MonoGameGum.Forms Compatibility Shims Removed

The MonoGameGum.Forms compatibility shims that were introduced in 2025 August have been deleted. These shims were marked [Obsolete(error: true)] since 2025 October, meaning any project referencing them was already a compile error.

If you migrated to Gum.Forms namespaces when the error was introduced, no action is needed. If your project still has using MonoGameGum.Forms.Controls or similar references, you must update them to the Gum.Forms equivalents:

Old Namespace	New Namespace
MonoGameGum.Forms	Gum.Forms
MonoGameGum.Forms.Controls	Gum.Forms.Controls
MonoGameGum.Forms.Controls.Primitives	Gum.Forms.Controls.Primitives
MonoGameGum.Forms.Data	Gum.Forms.Data
MonoGameGum.Forms.DefaultVisuals	Gum.Forms.DefaultVisuals