Upgrading

Introduction

The Gum tool and Gum NuGet packages are updated frequently. Most updates to both require no changes in your project. This page explains how to upgrade. See the subsections for upgrading between different versions to make sure you can upgrade safely.

How to Upgrade

If you are upgrading to a new version, you should read the upgrade documentation for all versions up to the version you are upgrading. For example, if you are upgrading from October 2025 to January 2026, then you should read the following documents:

• November 2025

• December 2025

• January 2025

Of course, you do not need to actually upgrade to each individual month along the way, but each month may introduce changes which are important for your project.

Upgrading the Gum Tool

The Gum tool is distributed as a .zip file which is not installed on your machine. Therefore, to upgrade Gum, you need to delete the folder that contains the unzipped files, download the latest .zip file, and unzip it.

The latest full release can be found in the Setup page.

The latest releases, including pre-releases, can be found on the GitHub Releases page. All previous releases can be found on the GitHub Releases page in case you need to run an old version.

Upgrading NuGet Packages

Gum frequently upgrades the NuGet packages with enhancements and bug fixes. To upgrade your project, upgrade the latest NuGet package through Visual Studio or the command line.