> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idyl.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Namespaces

> How namespaces scope workload resources inside an account.

A namespace groups related workload resources inside an account.

Use namespaces to separate environments, teams, applications, or other resource sets that should be listed and managed together.

## What namespaces scope

Workload commands use a namespace when creating, listing, updating, or deleting workload resources.

Examples of namespace-scoped resources include deployments, jobs, cron jobs, replica sets, and pods.

## Namespace and subnet

Namespaces and subnets are separate concepts.

| Concept   | Use it for                                     |
| --------- | ---------------------------------------------- |
| Namespace | Resource organization inside an account.       |
| Subnet    | Workload placement and capacity participation. |

A workload is scoped to a namespace and placed on a subnet.

## Default namespace

The CLI can store a namespace in the active context. Commands use the context namespace unless a command flag or manifest provides another value.

```bash theme={null}
idyl context edit --set-namespace <namespace>
idyl get deployment --namespace <namespace>
```

## Related guides

* [Namespace resource](/resources/namespaces)
* [Use a manifest](/build/use-a-manifest)
* [Inspect resources](/build/inspect-resources)