We’re excited to announce that Newsletter Studio v18, our fully supported release for Umbraco 18, is now officially available!
This release brings full compatibility with Umbraco’s latest version, updated dependencies, and a set of changes to keep Newsletter Studio aligned with the modern Umbraco platform. Whether you’re upgrading an existing site or starting a new Umbraco 18 project, Newsletter Studio is ready to go.
What's new in 18?
With this release we’ve focused on making sure Newsletter Studio works seamlessly on Umbraco 18, while continuing to modernize the internal APIs and package code.
Highlights include:
Full Umbraco 18 support
Newsletter Studio v18 targets Umbraco 18 and updates the package dependencies accordingly - giving you confidence that you can run campaigns, mailing lists, and transactional emails on the latest version of Umbraco.
As always, the goal is to keep the editor experience familiar and productive, while making sure the package follows the latest changes in the Umbraco ecosystem.
Async APIs
One of the bigger changes in this release is that most methods have been changed to be async.
This better aligns Newsletter Studio with modern .NET and Umbraco development patterns, and makes the package a better fit for scalable, non-blocking operations.
Breaking change: async method signatures
Because many methods are now async, this release contains breaking changes for developers who are using the Newsletter Studio APIs directly from custom code.
In most cases, upgrading means updating your code to await the new async methods and, where needed, changing return types to Task or Task<T>.
For example, code that previously looked like this:
var mailingList = mailingListService.Get(id);
var mailingList = mailingListService.Get(id);may now need to be updated to:
var mailingList = await mailingListService.GetAsync(id);The exact changes depend on which APIs you are using, so please make sure to test any custom integrations carefully when upgrading.
Bug fixes and quality improvements
We’ve also made various compatibility adjustments and internal improvements to ensure a smooth experience on Umbraco 18.
Try it today!
Just install using your favorite NuGet tool:
dotnet add package NewsletterStudio --version 18.0.0
As always, please make sure to back up your files and database before installing or upgrading. If you run into any issues, don’t hesitate to reach out.
Links
Release notes
https://www.newsletterstudio.org/versions/18/
NuGet
https://www.nuget.org/packages/NewsletterStudio/18.0.0
Documentation
https://www.newsletterstudio.org/documentation/package/getting-started/installation/
