---
title: "Edit an Environment"
description: "Learn to update your Contentstack Environment to adjust deployment settings via UI or API for seamless publishing."
url: "https://www.contentstack.com/docs/headless-cms/edit-an-environment"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-07-23"
---

# Edit an Environment

Editing an [environment](/docs/headless-cms/about-environments) allows you to update its details, adapt to workflow changes, and ensure smooth content deployment.

**Note:** Only the stack [Admin](/docs/headless-cms/types-of-roles#admin) and [Developer](/docs/headless-cms/types-of-roles#developer) can edit an environment.

To edit an Environment, log in to your [Contentstack account](https://www.contentstack.com/login/) and perform the following steps:

1.  Go to your [stack](/docs/headless-cms/about-stack) and click the “Settings” icon or use the shortcut key “S” (for Windows and Mac OS users).
2.  Navigate to **Environments** or use the “alt + E” shortcut key for Windows and “option + E” for Mac OS.
3.  Click the vertical ellipsis icon next to an environment in the **Actions** menu and select **Edit**.
4.  Update the details in the **Edit Environment** modal and click **Save**.
    
    ![Edit Environment modal with fields to update environment details](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt229bd80a997e55f2/67dd59ada71458fdd9b9b33e/1-Edit-an-Environment-gif.gif "Edit Environment Modal")
    

**Note:** You can use [Webhooks](/docs/headless-cms/about-webhooks) to trigger deployments to multiple servers when you publish content.

## API Reference

To edit an environment via API, refer to the [Update an API](/docs/developers/apis/content-management-api/environment#update-environment) request.