Documentation

Edit a Workspace

Editing a Workspace

You need the 'workspace.edit' permission to modify workspaces.

How to Edit a Workspace

  1. 1
    Navigate to the Workspaces list for your project
  2. 2
    Find the workspace you want to edit
  3. 3
    Click the pencil/edit icon on the workspace card
  4. 4
    The Edit Workspace dialog opens
  5. 5
    Update the workspace name or state bucket as needed
  6. 6
    Click 'Save'

What Can Be Changed

  • Workspace name (changing this does not affect Terraform state)
  • State bucket path (if migrating from local to remote state)

Important

  • If you change the state bucket, you may need to migrate your Terraform state manually
  • Consult your team before changing the state bucket in a shared workspace