Promoting a production workspace to Master is the final step in making an app publicly available to end users. After launching your app as a stable version and thoroughly testing it in a production workspace, you can promote your workspace to Master to make your new app version publicly available to end users.

Note that once promoted to Master, you can't make new code changes in your app version. Alternatively, you would need to develop your code in a development workspace and reproduce it in a new production workspace, so you could test your changes with user traffic before making your new changes publicly available.

Before proceeding any further, make sure your app has been published in the workspace you are about to promote.

Also, remember that when you promote a workspace to master, your changes are applied to all workspaces of the current account. Hence, if you are promoting a new version of the Store Theme app to master, make sure to complete all the necessary adjustments to store content in Site Editor and to your code beforehand.

Promoting a workspace to Master is a step in making your new app version publicly available. Please check this guide for more information.

Follow these steps to promote a production workspace to Master. Remember to replace the values between curly brackets according to your scenario.

1. Open the terminal and log in to your VTEX account.

   vtex login {accountName}
   

2. Change to the production workspace to be promoted.

   vtex use {workspaceName}
   

3. Promote the workspace being used.

   vtex workspace promote