IBM Support

Difference Between Edit Variable Set and Remove Variable Set in HCP Terraform

Troubleshooting


Problem

NOTE: 

This article applies to Variable Sets assigned to selected individual workspaces, NOT to entire projects.

If Variable Set is assigned to a project, you have only the "Edit" option on a workspace level.
 


Overview

Variable sets in HCP Terraform allow organizations to centrally manage variables and share them across multiple workspaces. When working with variable sets at the workspace level, users often encounter two actions:

  • Edit Variable Set

  • Remove Variable Set

Although these actions may appear similar, they have very different scopes and impacts. This article explains the difference to help you choose the correct action and avoid unintended changes.

NOTE: 

Remove Variable Set

What it does

Remove Variable Set simply detaches the variable set from the selected workspace.

  • The variable set itself remains intact at the organization level.

  • Other workspaces that use the same variable set are not affected.

  • No variables are deleted or modified.

When to use it

Use Remove Variable Set when:

  • You want a variable set to no longer apply to a specific workspace only.

  • You are cleaning up workspace-specific configuration.

  • You do not want to impact other workspaces.

Key takeaway

Variable set remove will just detach the Variable set from the workspace.
If you want to remove a variable set from a specific workspace, this is the correct option.


Edit Variable Set

What it does

Edit Variable Set redirects you to the organization-level configuration of the variable set.

From there, you can:

  • Add, modify, or delete variables

  • Change variable values or sensitivity

  • Delete the entire variable set

Impact scope

  • All workspaces that have this variable set assigned will be affected.

  • Changes take effect globally wherever the variable set is in use.

When to use it

Use Edit Variable Set when:

  • You want to update shared variables across multiple workspaces.

  • You need to correct or rotate values centrally.

  • You intentionally want consistent changes applied everywhere.

Key takeaway

Variable set edit will redirect the user to the Variable set configuration on organization level.
Editing or deleting variables from the variable set will affect all workspaces where the variable set is assigned.

 

Side-by-Side Comparison

Action Scope Affects Other Workspaces Use Case
Remove Variable Set Workspace-level ❌ No Detach from one workspace
Edit Variable Set Organization-level ✅ Yes Update shared variables

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSTYDYO","label":"IBM Terraform"},"ARM Category":[{"code":"","label":""}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]

Historical Number

49415126245395

Document Information

Modified date:
16 March 2026

UID

ibm17263904