Namespace creation - Temporal Cloud feature guide

How to create a Namespace in Temporal Cloud

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, Account Owner, or Global Admin account-level Role.

tip

By default, each account is allocated with a limit of ten Namespaces. As you start using Namespaces by scheduling Workflows, Temporal Cloud automatically raises your allowance. This automatic adjustment happens whenever all your Namespaces are in use, up to a maximum of 100 Namespaces. You can request further increases beyond the 100 Namespace limit by opening a support ticket.

Information needed to create a Namespace

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

• Namespace Name, region, and Cloud Provider
• Retention Period for the Event History of closed Workflow Executions.
• CA certificate for the Namespace, if you are using mTLS authentication.
• Codec Server endpoint to show decoded payloads to users in the Event History for Workflow Executions in the Namespace. For details, see Securing your data.
• Permissions for each user.

Web UI

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 Cloud Provider, select the cloud provider in which to host this Namespace.
7. In Region, select the region in which to host this Namespace.
8. 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.)
9. Select your authentication method: API keys or mTLS.
10. If using mTLS authentication, paste the CA certificate for this Namespace.
11. Optional: In Codec Server, enter the HTTPS URL (including the port number) of your Codec Server endpoint. You may also enable "Pass the user access token with your endpoint" and "Include cross-origin credentials." For details, see Hosting your Codec Server.
12. Click Create Namespace.

tcld

See the tcld namespace create command reference for details.