Promoting Changes to Production

The Main Event! You’ve added new features to your apps in a Promotable Sandbox, tested them, and now you’re ready to promote them to your users who are working in Production. Let's look at what happens when you promote changes and review best practices for scheduling a promotion to Production.


What to Expect when you click ‘Promote’!

Promoting changes from a Promotable Sandbox to Production is as easy as the click of a button! But, there’s a lot that happens when you click that button, so let's walk through an example to see how it works:


The Use Case

My TrackVia account currently houses one Project Tracking app that my company uses to manage their work:



Recently, HR inquired about creating an app to manage HR Incidents and escalations. To make sure I didn’t disrupt anyone working in Production, I built the HR app in a Promotable Sandbox:


Note that the HR app shares a common “Employees” table with the Project Tracking app.


Once all updates have been thoroughly tested in your Promotable Sandbox, it’s time to promote those changes to Production:



Best Practice

Prior to Promoting changes to Production, we recommend that you access the Changelog for your Promotable Sandbox to ensure that no other App Admin or Super Admin have been making changes in the sandbox that you are not aware of:



We will cover the details of the Changelog itself in this article.

Once you are ready to Promote your changes to Production and click “Promote”, you will see the following message:


Best Practice

Once you confirm that you want to promote changes to Production by clicking “Promote Sandbox” users will not be able to access your account for the duration of the promotion. Therefore, we recommend that you promote changes after business hours or at a specified Maintenance Downtime window that you have scheduled with your business.


The Promotion Event

When you are finally ready to promote your changes, the TrackVia system follows a four-step process that it is important for your Super Admin to understand:



  1. As soon as you click “Promote Sandbox” TrackVia checks to ensure that the system can successfully Promote your changes before logging you and all users out of the system.


Note: If a long-running import is adding data to your Production system, your Super Admin will see an error indicating that the import process needs to finish first.


Assuming that your Promotion is able to start, TrackVia moves to the next step of the process:


  1. In order to ensure that you have a fail-back precaution for any unintended issues, TrackVia creates a backup of your Production account directly as it exists before the Promotion event. This backup is available under the Backup & Restore tab of the ‘My Account’ area in your account:


  1. During the promotion of your changes from the Promotable Sandbox to Production, users who are working offline will be able to continue adding and editing data in the app. For more information on how Promotable Sandboxes and Offline Mobile work, see this article.

Note: If your Production account has Microservices or Workato recipes connected to it, those integrations will receive error messages while the Promotion event is taking place. Please ensure that all integrations are paused prior to Promoting changes or ensure that your integrations have the proper logic to handle and retry failed data once Production becomes unlocked.


  1. Once the promotion is complete, you will receive an email letting you know that your Production account is unlocked and users can access the app!


Note: If for any reason the Promotion is unsuccessful, the TrackVia system will restore your Production account to the state prior to promoting changes and you will receive an email which you can utilize to triage the issue with the TrackVia Support Team.


Up Next: Anatomy of the Changelog






Feedback and Knowledge Base