Skip to main content

How to manage Namespaces in Temporal Cloud

A Namespace is a unit of isolation within the Temporal Platform.

Create a Namespace

info

The user who creates a Namespace is automatically granted Namespace Admin permission for that Namespace.

To create a Namespace, a user must have the Developer or Global Admin account-level Role.

tip

By default, each account has a quota of 10 Namespaces. If you want to increase this limit, open a support ticket.

Information needed to create a Namespace

To create a Namespace in Temporal Cloud, gather the following information:

Create a Namespace using Temporal Cloud UI

  1. Gather the information listed earlier in Information needed to create a Namespace.
  2. Go to the Temporal Cloud UI and log in.
  3. On the left side of the window, click Namespaces.
  4. On the Namespaces page, click Create Namespace in the upper-right portion of the window.
  5. On the Create Namespace page in Name, enter the Namespace Name.
  6. In Region, select the region in which to host this Namespace.
  7. In Retention Period, specify a value from 1 to 90 days. When choosing this value, consider your needs for Event History versus the cost of maintaining that Event History. Typically, a development Namespace has a short retention period and a production Namespace has a longer retention period. (If you need to change this value later, contact Temporal Support.)
  8. In Certificate, paste the CA certificate for this Namespace.
  9. Click Create Namespace.

Create a Namespace using tcld

This functionality is in development.

Access Namespaces

Each Namespace in Temporal Cloud has two unique endpoints, both of which include the Namespace Id.

  • For programmatic access, a gRPC endpoint in the form <NamespaceId>.tmprl.cloud; for example, accounting-production.f45a2.tmprl.cloud:7233.
  • For accessing Temporal Web UI, an HTTPS endpoint in the form web.<namespaceId>.tmprl.cloud; for example, https://web.accounting-production.f45a2.tmprl.cloud.

Manage Namespaces

Manage Namespaces in Temporal Cloud using Temporal Cloud UI

To list Namespaces:

  • On the left side of the window, click Namespaces.

To edit a Namespace (including custom Search Attributes, certificates, certificate filters, and permissions), find the Namespace and do either of the following:

  • On the right end of the Namespace row, click the three vertical dots (⋮). Click Edit.
  • Click the Namespace name. In the top-right portion of the page, click Edit.

On the Edit page, you can do the following:

After you make changes, click Save in the top-right or bottom-left portion of the page.

Manage Namespaces in Temporal Cloud using tcld

To list Namespaces and get information about them, use the following tcld commands:

To manage certificates, use the tcld namespace accepted-client-caLink preview icon

commands. For more information, see How to manage certificates in Temporal Cloud.

To manage certificate filters, use the tcld namespace certificate-filtersLink preview icon

commands. For more information, see How to manage certificate filters in Temporal Cloud.