Documentation
Feedback
Guides
App Development

App Development
Deployment
Promoting a workspace to Master

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.

{"base64":"  ","img":{"width":666,"height":738,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":55881,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/vtex-io-documentation-promoting-a-workspace-to-master-0.gif"}}

Before you begin

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

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. Furthermore, the apps installed in the promoted workspace will be installed in all the other workspaces, which is described on Workspace behavior with app installations.

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

Step by step

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.


    _10
    vtex login {accountName}

  2. Change to the production workspace to be promoted.


    _10
    vtex use {workspaceName}

  3. Promote the workspace being used.


    _10
    vtex workspace promote

Contributors
4
Photo of the contributor
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 4 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
4
Photo of the contributor
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 4 contributors
On this page