---
title: "Add descriptions to Temporal Cloud namespaces"
description: "Add a short description to each Temporal Cloud namespace so your team can quickly understand its purpose."
canonical: "https://temporal.io/changelog/add-descriptions-temporal-cloud-namespaces-ga.md"
source: "https://temporal.io/changelog/add-descriptions-temporal-cloud-namespaces-ga"
date: "2026-09-29"
change_type: "Feature"
product_areas:
  - "Cloud"
  - "UI"
  - "Temporal CLI"
---

# Add descriptions to Temporal Cloud namespaces

You can now add an optional description to any Temporal Cloud namespace to explain what it's for. Descriptions can be set during namespace creation or edited later via Web UI, Cloud Operations API,  Temporal CLI and Terraform.

Descriptions are visible to users with Namespace Read access. Do not include secrets, personal data, or other confidential information.

- [Namespace Description Documentation](https://docs.temporal.io/cloud/namespaces#describe-a-namespace)
