Upgrading Task Factory

 Task Factory users running version 2020.1.4 or older (released prior to May 27, 2020): There's an important Task Factory update. Please visit here for more details.

Introduction & Notes

Upgrade to the latest version of Task Factory to access the new and updated components released by SentryOne. For more information about what the newer versions have to offer and the latest version number, see the Release Notes article.


  • Before upgrading your current version of Task Factory, SentryOne recommends creating a backup of your packages to ensure that you can revert back to a previous version if any issues occur.
  • It's recommended that you test upgrades before rolling them out to your production environment. See the Testing the Task Factory Upgrade article for instructions.
  • Close any Visual Studio windows before starting an upgrade.


1. Uninstall Task Factory

Uninstall your current version of Task Factory. Open the Control Panel > Programs > Programs and Features, right click Task Factory, then select Uninstall. Select Yes to start the uninstall process.

Task Factory Uninstall current version from the Control Panel
Uninstall Task Factory
Task Factory confirm uninstall
Confirm Uninstall

Task Factory Uninstalling progress
Uninstalling Progress

2. Download Latest Version of Task Factory

Log into your SentryOne account at https://my.sentryone.com/ to download the latest version of Task Factory.

Note:  License administrators can get the latest download from the customer portal above, but all other users need to get it from the the support community at https://support.sentryone.com/s/ under Resources Task Factory/Workbench Download Links. You must be logged in to access it on the support community.

Task Factory Log into SentryOne Portal
Log into SentryOne Portal

Task Factory Download new version
Download new version

3. Install Task Factory

Complete the Installation process for Task Factory to begin using new components.


How do I know which version of Task Factory is installed?

Most Task Factory components display the version number next to the name of the component when you are viewing the component editor UI in Visual Studio. For additional ways to find the version number, see the How to Confirm Task Factory Version article.

Manual Deletion of Assemblies after Uninstalling Task Factory

If any assembly files remain after uninstalling Task Factory, they may lead to problems later on when you attempt to run a package. Many different errors can be thrown in this situation. See the Manual Deletion of Assemblies after Uninstall of Task Factory article for all the file locations and instructions to fully remove them.