Using Environments
After Setting Up Environments for a Space, you can determine which models and content entries are synced to your main environment.
Prerequisites
- Builder Admin permissions in a space with an Enterprise plan
- More than one environment
Syncing environments with Live Sync
Turning off Live Sync for a model
- Go to Account Settings.
- On the Environments tab, enter the environment where you'd like to turn off Live Sync. Note that you can only turn off Live Sync in child environments.
- In the environment, go to Models.
- Click on the Model you'd like to unlink.
- On the upper right of the Model, click the down arrow next to the Linked indicator and select Turn Off Live Sync.
- In the confirmation dialogue that opens, click the Turn Off Live Sync button. The Linked indicator changes to Unlinked.
The following video demonstrates turning off Live Sync for a model.
Turning on Live Sync for models
- Go to Account Settings.
- On the Environments tab, enter the environment where you'd like to turn on Live Sync. Note that you can only turn on Live Sync in non-prod environments.
- In the environment, go to Models.
- Click on the Model you'd like to unlink.
- On the upper right of the Model, click the down arrow next to the Unlinked indicator and select Turn On Live Sync.
- In the confirmation dialogue that opens, click the Turn Off Live Sync button. The Unlinked indicator changes to Linked.
The following video demonstrates turning on Live Sync for a model.
Turning off Live Sync for content
- Go to Account Settings.
- On the Environments tab, enter the environment where you'd like to turn off Live Sync.
- In the environment, go to Content.
- Click on the content entry you'd like to unlink.
- In the Visual Editor, at the top, click the down arrow next to the Linked indicator and select Turn Off Live Sync.
- In the confirmation dialogue that opens, click the Turn Off Live Sync button. The Linked indicator changes to Unlinked.
The following video demonstrates turning off Live Sync for a content entry.
Turning on Live Sync for content
- Go to Account Settings.
- On the Environments tab, enter the environment where you'd like to turn off live sync.
- In the environment, go to Content.
- Click on the content entry you'd like to link.
- At the top of the Visual Editor, click the down arrow next to the Unlinked indicator and select Turn on Live Sync.
The following video demonstrates turning on Live Sync for a content entry.
Pushing changes from a child environment
Pushing is a manual process of copying updates in the following ways:
- from a child environment to the main environment
- from a child environment to another child environment
If you create or edit content or models in a child environment and want those changes in main, you must push in order of dependency:
- Push all changed models.
- Push dependent content, such as Symbols.
- Push the content.
Pushing model changes
- Go to Account Settings.
- On the Environments tab, enter the environment with the updated model whose changes you'd like to push up.
- In the environment, go to Models.
- Click on the Model you'd like to edit.
- Edit the model.
- On the upper right of the Model, click the down arrow next to the Unlinked indicator and select Push to
environment. - In the confirmation dialogue that opens, click the Yes, Push Now button. Notice that the Unlinked indicator changes to Linked.
The following video demonstrates pushing changes from an environment named Dev to an environment named Prod and then shows going to Prod to display the changes.
Pushing content changes
- Go to Account Settings.
- On the Environments tab, enter the environment with the updated model whose changes you'd like to push up.
- In the environment, go to Content.
- Click on the content entry you'd like to push.
- In the Visual Editor, at the top, click the down arrow next to the Unlinked indicator and select Push to Main.
- In the confirmation dialogue that opens, click the Yes, Push Now button. Notice that the Unlinked indicator changes to Linked.
The following video demonstrates pushing content changes from an environment named Dev to an environment named Prod and then shows going to Prod to view the changes.
Re-syncing an Environment
Re-syncing is the process of resetting an environment to mirror its parent space.
- Go to Account Settings.
- On the Environments tab, click the three dots to the far right of the Environment you'd like to re-sync.
- In the menu that opens, select Resync.
- Confirm that you'd like to re-sync the environment.
The following video demonstrates re-syncing an environment.