A publishing environment corresponds to one or more deployment servers or a content delivery destination where the entries need to be published. The most common publishing environments used are development, staging, and production.

Add an Environment

Go to Settings > Environments to view the list of all the available environments for a stack. Click + New Environment to create a new one. The Create Environment dialog box that appears allows you to add details about the destination.

Enter environment name

This could a name of your choice. The most common environment names are staging, development, and production.

Specify base URL

The Base URL is the consistent part of the destination’s web address (for example, http://localhost:4000, http://www.example-site.com). It helps Built.io Contentstack identify the destination to which the content will be published. The base URL is used as a prefix when the URL of an entry is generated. It is important to note that base URL would be different if using different languages (for example, http://www.example-site.com/en/).

In case of mobile apps or other devices, you need not enter the base URL. This is because apps fetch content directly from Built.io Contentstack servers through APIs.

Advanced settings

The content will be published to the specified destination server(s) only if Deploy Content to Server(s) is enabled. Disabling this will let you publish the entry without having it to be deployed on the server. This is especially useful while building mobile apps, single page app, etc. You can also add multiple servers for an environment.

Tutorial Video

In this short video, we will create a development environment with base URL as http://localhost:4000


Edit an Environment

In Settings > Environment, you can view the list of all the environments created for a stack. To edit the details, simply click the name of the environment. This will open the Update Environment dialog box, where you can update the name, base URL, language, and advanced settings of the environment.

Tutorial Video


Delete an Environment

To delete an existing environment of a stack, go to Settings > Environment. When you hover on any of the environments, you will notice a More Options icon on the right. Click this icon to get the Delete option.

Tutorial Video