Getting to know about workspaces

Getting to know more about workspaces


Workspaces are environments isolated from one another, containing different versions of the same VTEX account. In practice, this means that changes performed in your own workspace do not affect your store's live version and other developers' work.

There are two main types of workspaces:

  • Development workspace: allows linking, developing, installing, and publishing apps. It provides more configuration freedom. But it can't handle production traffic, be promoted to master, or be used for A/B testing.
  • Production workspace: supports production traffic and A/B testing. It can be promoted to master, but linking apps is forbidden.

A Master workspace is a unique production workspace that reflects the content served to the store's end-user.

Creating a production workspace

In this step, we're going to create a production workspace and it's as simple as running the following command of our CLI:

vtex use {WorkspaceName} --production

WorkspaceName is the name that you want to use to identify your workspace.

Once you run the command, if the provided name does not exist, one will be asked if want to create it, as you can see in the following image:


In that case, you just need to type y:


You're done! Your production workspace has been created! In order to verify which workspace and account you are currently on, you can use the following command:

vtex whoami

Help us make this content better!

VTEX IO courses are open source. If you see something wrong, you can open a pull request!

Make a contribution

or open an issue