# Launch Environments ### About this export | Field | Value | | --- | --- | | **content_type** | lesson | | **platform** | contentstack-academy | | **source_url** | https://www.contentstack.com/academy/courses/launch-foundations/launch-environments | | **course_slug** | launch-foundations | | **lesson_slug** | launch-environments | | **markdown_file_url** | /academy/md/courses/launch-foundations/launch-environments.md | | **generated_at** | 2026-04-28T06:55:46.423Z | > Part of **[Launch Foundations](https://www.contentstack.com/academy/courses/launch-foundations)** on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys. #### Lesson text ## Launch Environments Environments allow you to deploy and host different versions of your project independently. Launch allows you to set up multiple environments for a project, which you can configure to match your development style. Each environment is deployed and hosted on a unique URL. Auto-deploy is enabled by default for every environment. A default environment is created with every project import. You can configure the environment as per your needs for further usage. This document guides you through the process of creating, configuring, and deleting an environment in Launch. ## Prerequisites 1. [Contentstack account](https://www.contentstack.com/login/) 2. Access to Launch for your organization ## Create an Environment 1. Click the project card to open your project from the Launch landing page.  ![Launch\_-\_Projects.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4a98e187b26f92e0/643e30f71a1ec621c9be6010/Launch_-_Projects.png)  2. In the Environments screen, click the **\+ New Environment** button to add a new environment.  ![Launch-Env\_Screen-New\_Env.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltffe2f7d8df3b3ac2/643fc3adab59a227af420039/Launch-Env_Screen-New_Env.png)  3. In the **Create New Environment** modal, fill in the following: 1. If you choose GitHub to deploy your project, follow the steps below: 1. Enter an environment name. 2. Select a branch from the **Git Branch** dropdown. 3. The fields in the Build and Output Settings section get auto-populated based on the detected framework. You can always change the Framework Preset and the build and output commands as per your requirement.![Launch-Create-Env-Git-BuildandOutput.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt59fada371ac34bcb/643fc3adb1f4db27b0204145/Launch-Create-Env-Git-BuildandOutput.png) 4. In the Environment Variables field, perform the following: * If you want to [auto-populate environment variables from a linked stack](https://www.contentstack.com/docs/developers/launch/auto-populate-environment-variables-from-a-linked-stack/), select a stack and click the **Import Variables** button. * Click the **\+ Add Environment Variable** button to manually add environment variable(s).  ![Launch-Create-Env-Env-Variables.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt523fe31b486c6442/643fc3addfdb9232fd8bb0cd/Launch-Create-Env-Env-Variables.png)  5. Click the **Create** button. You have successfully created an environment. 2. If you choose to upload a file to deploy your project, follow the steps below: 1. Enter an environment name. 2. The Upload a file field allows you to browse and upload a new file. Click **browse to upload** to upload a project file. You can also re-upload a different file after uploading a file.  ![Launch-Create-Env-File-UploadFile.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt8e5e9a3bc26db3aa/643fc3ad3e745b11edf82044/Launch-Create-Env-File-UploadFile.png)  3. The fields in the Build and Output Settings section get auto-populated based on the detected framework in the uploaded file. You can always change the Framework Preset and the build and output commands as per your requirement.  ![Launch-Create-Env-File-BuildandOutput.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltf82bbcb2d2c6e665/643fc3ad9074ca2928c7a12b/Launch-Create-Env-File-BuildandOutput.png)  4. In the Environment Variables field, perform the following: * If you want to [auto-populate environment variables from a linked stack](https://www.contentstack.com/docs/developers/launch/auto-populate-environment-variables-from-a-linked-stack/), select a stack and click the **Import Variables** button. * Click the **\+ Add Environment Variable** button to manually add environment variable(s).  ![Launch-Create-Env-Env-Variables.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt523fe31b486c6442/643fc3addfdb9232fd8bb0cd/Launch-Create-Env-Env-Variables.png)  6. Click the **Create** button. You have successfully created an environment. **Note**: When you import a project by uploading a file, the icon for Branch specification is not displayed in the Environments section. ## Configure an environment You can change the environment name and branch from **Settings**. **Note**: When you import a project by uploading a file, the Git Branch section in the General settings is not available. You can configure environments to use deploy hooks, custom domains, and environment variables. You can control the deployment behavior by toggling auto-deployments. 1. In the Environments screen, hover over the **environment** where your project is created and then click the **Environment Settings** icon to go to Environment Settings.  ![Launch-Env\_Settings.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4411ebf033dcd7c5/643e9879e8b191595dde432a/Launch-Env_Settings.png)  2. Edit the environment name and branch. ![Launch\_Environments\_Name\_Branch.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltb44324eff9ad0522/64a65dafb62fa4579aab8548/Launch_Environments_Name_Branch.png) 3. Click the **Save** button. **Note**: The auto-deployment feature is unavailable when you import a project by uploading a file. ## Delete an environment Launch allows you to delete an environment that you no longer require. Follow the steps below to delete an environment: 1. In the Environments screen, hover over the **environment** you want to delete and click the **Delete Environment** button. ![Launch\_Environments\_DeletePart2SS1.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt12bd365863f4029a/64a65daf7b26df745ce167c6/Launch_Environments_DeletePart2SS1.png) 2. Enter DELETE and then click the **Yes, Delete** button. Alternatively, you can follow the steps below to delete an environment: A modal is displayed asking for confirmation to delete the environment. **Note**: On deleting an environment, its corresponding deployments also get deleted. 1. In the Environments screen, hover over the **environment** you want to delete and click the **Environment Settings** icon to go to Environment Settings. ![Launch\_Environments\_Settings.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt07afb18cce01cfff/64a65daf05df43c8a75ae6f3/Launch_Environments_Settings.png) 2. Under Advanced in the Environments section, click the **Delete Environment** button. You will see a warning message displayed above the button. 3. Enter DELETE and then click the **Yes, Delete** button. #### Key takeaways - Connect **Launch Environments** back to your stack configuration before moving to the next module. - Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment. - Re-read the delivery versus management boundary for anything you changed in the entry model. ## Supplement for indexing ### Content summary Launch Environments. Launch Environments Environments allow you to deploy and host different versions of your project independently. Launch allows you to set up multiple environments for a project, which you can configure to match your development style. Each environment is deployed and hosted on a unique URL. Auto-deploy is enabled by default for every environment. A default environment is created with every project import. You can configure the environment as per your needs for further usage. This document guides you through the process of creating, configuring, and deleting an environment in Launch. Prerequisites 1. Contentstack account (https://www.contentstack.com/login/) 2. Access to Launch for your organi ### Retrieval tags - Launch - Environments - launch-foundations - lesson 07 - Launch Environments - launch-foundations lesson ### Indexing notes Index this lesson as a primary chunk tagged with lesson_id "07" and topics: [Launch, Environments]. Parent course slug: launch-foundations. Use asset_references URLs as thumbnail hints in search results when present. Never surface LMS quiz content or assessment answers from this file. ### Asset references | Label | URL | | --- | --- | | Launch\_-\_Projects.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4a98e187b26f92e0/643e30f71a1ec621c9be6010/Launch_-_Projects.png` | | Launch-Env\_Screen-New\_Env.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltffe2f7d8df3b3ac2/643fc3adab59a227af420039/Launch-Env_Screen-New_Env.png` | | Launch-Create-Env-Git-BuildandOutput.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt59fada371ac34bcb/643fc3adb1f4db27b0204145/Launch-Create-Env-Git-BuildandOutput.png` | | Launch-Create-Env-Env-Variables.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt523fe31b486c6442/643fc3addfdb9232fd8bb0cd/Launch-Create-Env-Env-Variables.png` | | Launch-Create-Env-File-UploadFile.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt8e5e9a3bc26db3aa/643fc3ad3e745b11edf82044/Launch-Create-Env-File-UploadFile.png` | | Launch-Create-Env-File-BuildandOutput.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltf82bbcb2d2c6e665/643fc3ad9074ca2928c7a12b/Launch-Create-Env-File-BuildandOutput.png` | | Launch-Create-Env-Env-Variables.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt523fe31b486c6442/643fc3addfdb9232fd8bb0cd/Launch-Create-Env-Env-Variables.png` | | Launch-Env\_Settings.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4411ebf033dcd7c5/643e9879e8b191595dde432a/Launch-Env_Settings.png` | | Launch\_Environments\_Name\_Branch.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltb44324eff9ad0522/64a65dafb62fa4579aab8548/Launch_Environments_Name_Branch.png` | | Launch\_Environments\_DeletePart2SS1.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt12bd365863f4029a/64a65daf7b26df745ce167c6/Launch_Environments_DeletePart2SS1.png` | | Launch\_Environments\_Settings.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt07afb18cce01cfff/64a65daf05df43c8a75ae6f3/Launch_Environments_Settings.png` | ### External links | Label | URL | | --- | --- | | Contentstack Academy home | `https://www.contentstack.com/academy/` | | Training instance setup | `https://www.contentstack.com/academy/training-instance` | | Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` | | Contentstack documentation | `https://www.contentstack.com/docs/` | | Contentstack account | `https://www.contentstack.com/login/` | | Launch\_-\_Projects.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4a98e187b26f92e0/643e30f71a1ec621c9be6010/Launch_-_Projects.png` | | Launch-Env\_Screen-New\_Env.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltffe2f7d8df3b3ac2/643fc3adab59a227af420039/Launch-Env_Screen-New_Env.png` | | Launch-Create-Env-Git-BuildandOutput.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt59fada371ac34bcb/643fc3adb1f4db27b0204145/Launch-Create-Env-Git-BuildandOutput.png` | | auto-populate environment variables from a linked stack | `https://www.contentstack.com/docs/developers/launch/auto-populate-environment-variables-from-a-linked-stack/` | | Launch-Create-Env-Env-Variables.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt523fe31b486c6442/643fc3addfdb9232fd8bb0cd/Launch-Create-Env-Env-Variables.png` | | Launch-Create-Env-File-UploadFile.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt8e5e9a3bc26db3aa/643fc3ad3e745b11edf82044/Launch-Create-Env-File-UploadFile.png` | | Launch-Create-Env-File-BuildandOutput.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltf82bbcb2d2c6e665/643fc3ad9074ca2928c7a12b/Launch-Create-Env-File-BuildandOutput.png` | | Launch-Env\_Settings.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt4411ebf033dcd7c5/643e9879e8b191595dde432a/Launch-Env_Settings.png` | | Launch\_Environments\_Name\_Branch.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/bltb44324eff9ad0522/64a65dafb62fa4579aab8548/Launch_Environments_Name_Branch.png` | | Launch\_Environments\_DeletePart2SS1.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt12bd365863f4029a/64a65daf7b26df745ce167c6/Launch_Environments_DeletePart2SS1.png` | | Launch\_Environments\_Settings.png | `https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt07afb18cce01cfff/64a65daf05df43c8a75ae6f3/Launch_Environments_Settings.png` |