--- title: "Updating your GdPicture.NET version" canonical_url: "https://www.nutrient.io/guides/dotnet/updating-gdpicture-guide/" md_url: "https://www.nutrient.io/guides/dotnet/updating-gdpicture-guide.md" last_updated: "2026-06-24T00:00:00.000Z" description: "Update your Nutrient .NET SDK integration with version-specific NuGet package and licensing guidance." --- # Updating your GdPicture.NET version Keep your Nutrient.NET SDK integration up to date to get current fixes, format support, and product improvements. This guide explains what to expect when you update from an older GdPicture.NET version, which NuGet packages to add, and how to register your license. ## Plan your update Most applications can update to the latest version without changing existing code. Nutrient.NET SDK is designed for backward compatibility, so most updates, including major-version updates, don’t require broad API changes. If you use a version that’s more than 10 years old, such as V9 or earlier, you may need to make some code changes. The core concepts remain similar, but older versions have less documentation and a less direct update path. ## Update your NuGet packages The packages you need depend on the version you’re updating to. The [ORPALIS NuGet profile](https://www.nuget.org/profiles/ORPALIS) lists the available GdPicture packages. ### V14.4.0 and later Starting with V14.4.0, Nutrient.NET SDK uses focused NuGet packages. Add only the packages your application needs. Add the following packages to your project: - **`GdPicture.NET`**, or **`GdPicture.API`** for non-UI applications. - One runtime package for your target platform: - **`GdPicture.Runtime.Windows`** — For Windows. - **`GdPicture.Runtime.Linux`** — For Linux. - **`GdPicture.Runtime.macOS`** — For macOS. - If your application uses UI controls, add one UI package for your framework: - **`GdPicture.WinForms`** — For Windows Forms applications. - **`GdPicture.WPF`** — For WPF applications. - **`GdPicture.MAUI`** — For cross-platform.NET MAUI applications. If your application uses optical character recognition (OCR), also add: - **`GdPicture.Resources`** — Contains the language data and assets required for OCR. Register your license key in code to unlock the SDK. For more information, refer to the [licensing](#licensing) section. ### V14.2.X and V14.3.X For V14.2.X and V14.3.X, the package structure is simpler. Add one of these packages: - **`GdPicture.NET`** - **`GdPicture.API`** If your application uses OCR, also add: - **`GdPicture.Resources`** Register your license key in code to unlock the SDK. ### V14.1.X and earlier For V14.1.X, use the **`GdPicture.NET`** NuGet package. If you need a version older than V14.1.144, the NuGet package isn’t available for that build. [Contact our Support team](https://support.nutrient.io/hc/en-us/requests/new) and we’ll provide the GdPicture installer. Licensing for V14.1.X works differently from later versions. Register your license key in two places: - The **LicenseManager.exe** tool included with the downloaded installer. - Your **application code**, using the standard license registration call. For V9 through V12, the process is broadly similar to V14.1.X. These versions have reached end of life, and documentation for them is limited. We recommend updating to a more recent version so you can receive full support. If you can’t update right away, [contact our Support team](https://support.nutrient.io/hc/en-us/requests/new). We’ll do our best to help, but our ability to diagnose issues in these older versions is limited. ## Licensing Register your license key early in your application’s startup sequence, before you initialize any GdPicture components. ```csharp // Register your GdPicture license key at application startup. GdPicture14.LicenseManager.RegisterKEY("YOUR-LICENSE-KEY-HERE"); ``` For V14.2.X and later, this code registration is the only licensing step. You don’t need an external tool or installer step. For V14.1.X, also register the license key in `LicenseManager.exe`. You need both registrations for the SDK to work. ## Summary | Version | NuGet package(s) | OCR support | Licensing | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ------------------------------------------ | | V14.4.0+ | `GdPicture.NET`/`GdPicture.API` + `GdPicture.Runtime.Windows`/`GdPicture.Runtime.Linux`/`GdPicture.Runtime.macOS`; add `GdPicture.WinForms`/`GdPicture.WPF`/`GdPicture.MAUI` only if you use UI controls | Add `GdPicture.Resources` | Register key in code only | | V14.2.X–V14.3.X | `GdPicture.NET`/`GdPicture.API` | Add `GdPicture.Resources` | Register key in code only | | V14.1.X | `GdPicture.NET` | Included | Register in `LicenseManager.exe` + in code | | V9–V12 | Contact Support for installer | Included | Similar to V14.1.X | ## Get help When you contact Support about an update issue, include the following information: - Your current version and the version you’re updating to. - The NuGet packages and versions you referenced. - Any error messages or unexpected behavior. - An isolated project that reproduces the issue as-is. Narrow it down to the problem instead of sharing your full project. - Screenshots, if they add useful context. [Contact our Support team](https://support.nutrient.io/hc/en-us/requests/new) and we’ll help you resolve the issue. --- ## Related pages - [C#.NET PDF library](/guides/dotnet.md) - [Agent skill](/guides/dotnet/agent-skill.md) - [Best practices for PDF processing in .NET](/guides/dotnet/best-practices.md) - [Changelog for .NET](/guides/dotnet/changelog.md) - [Explore interactive PDF SDK demos and features](/guides/dotnet/demo.md) - [Download Nutrient .NET SDK (formerly GdPicture.NET)](/guides/dotnet/downloads.md) - [Example Project](/guides/dotnet/getting-started/catalog-example.md) - [Nutrient .NET SDK guides — Add advanced PDF features to your .NET applications](/guides/dotnet/intro.md) - [C# and VB.NET code samples](/guides/dotnet/samples.md)