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

# Managing Buildkite Queues

export const CenteredImage = ({src, alt, width, caption, className}) => {
  const [basePath, setBasePath] = useState("");
  useEffect(() => {
    const path = window.location.pathname;
    setBasePath(path === "/docs" || path.startsWith("/docs/") ? "/docs" : "");
  }, []);
  return <Frame caption={caption} className={className} style={{
    maxWidth: width,
    marginInline: "auto"
  }}>
			<OptimizedImage src={`${basePath}${src}`} alt={alt} />
		</Frame>;
};

When you connect a Buildkite organization, Namespace creates and registers the first managed queue during setup. A new **Namespace Cluster** uses the `default` queue; an existing cluster uses the queue name selected during setup.

## Register another queue

1. In Buildkite, navigate to [**Agents**](https://buildkite.com/organizations/~/clusters) and select the cluster where you want to run Namespace agents.
2. Create a new **self-hosted** queue.

<CenteredImage width={700} alt="Buildkite queue creation" src="/docs/images/buildkite-agents/new_queue.png" />

3. Open **Buildkite → Organizations** in the [Namespace dashboard](https://cloud.namespace.so/workspace/buildkite/organizations). Click on the organization you want to manage, and then click **Queues**. This page lists all registered and unregistered queues, grouped by Buildkite cluster.
4. Find the queue and click **Register**.
5. Confirm the registration. Namespace creates an agent token and begins acquiring jobs from the queue.

<Info>
  Make sure that your webhook is configured to send events from the pipelines using this queue.

  [Webhook Settings →](https://buildkite.com/organizations/~/services)
</Info>

## Select a queue for a job

Set the `queue` agent tag on a pipeline or step to send jobs to the registered queue:

```yaml theme={null}
agents:
  queue: "my-queue"
```

## Unregister a queue

In the Namespace Queues page, open the menu next to a registered queue, select **Unregister**, and confirm. A queue cannot be unregistered while it has scheduled or running jobs in Namespace.

Unregistering a queue stops Namespace from provisioning agents for it and revokes the agent token created during registration. It does not delete the queue or its cluster from Buildkite.

## Next Steps

**[Configure Buildkite Agents](/docs/solutions/buildkite-agents/configuration)**. Choose compute resources, base images, and persistent caches with agent tags.