| title | Create a namespace | ||
|---|---|---|---|
| description | Provides step-by-step instructions to create an Azure Service Bus namespace using the Azure portal. | ||
| author | spelluru | ||
| ms.service | azure-service-bus | ||
| ms.topic | include | ||
| ms.date | 02/05/2026 | ||
| ms.author | spelluru | ||
| ms.custom |
|
To start using Service Bus messaging entities in Azure, create a namespace with a name that's unique across Azure. A namespace provides a scoping container for Service Bus resources, such as queues and topics, in your application.
To create a namespace:
-
Sign in to the Azure portal.
-
Select the flyout menu from the top left and go to the All services page.
-
On the left navigation bar, select Integration.
-
Scroll down to Messaging services, hover your mouse over Service Bus, and then select Create.
:::image type="content" source="./media/service-bus-create-namespace-portal/create-resource-service-bus-menu.png" alt-text="Screenshot showing selection of Create a resource, Integration, and then Service Bus in the menu." lightbox="./media/service-bus-create-namespace-portal/create-resource-service-bus-menu.png":::
-
In the Basics tab of the Create namespace page, follow these steps:
-
For Subscription, choose an Azure subscription in which to create the namespace.
-
For Resource group, choose an existing resource group, or create a new one.
-
Enter a Namespace name that meets the following naming conventions:
- The name must be unique across Azure. The system immediately checks to see if the name is available.
- The name length is at least 6 and at most 50 characters.
- The name can contain only letters, numbers, and hyphens
-. - The name must start with a letter and end with a letter or number.
- The name doesn't end with
-sbor-mgmt.
-
For Location, choose the region to host your namespace.
-
For Pricing tier, select the pricing tier (Basic, Standard, or Premium) for the namespace. For this quickstart, select Standard.
If you select the Premium tier, you can enable geo-replication for the namespace. The geo-replication feature ensures that the metadata and data of a namespace are continuously replicated from a primary region to one or more secondary regions.
[!IMPORTANT] If you want to use topics and subscriptions, choose either Standard or Premium. The Basic pricing tier doesn't support topics and subscriptions.
If you selected the Premium pricing tier, specify the number of messaging units. The premium tier provides resource isolation at the CPU and memory level so that each workload runs in isolation. This resource container is called as a messaging unit. A premium namespace has at least one messaging unit. You can select 1, 2, 4, 8, or 16 messaging units for each Service Bus Premium namespace. For more information, see Service Bus premium messaging tier.
-
Select Review + create at the bottom of the page.
:::image type="content" source="./media/service-bus-create-namespace-portal/create-namespace.png" alt-text="Screenshot showing the Create a namespace page." lightbox="./media/service-bus-create-namespace-portal/create-namespace.png":::
-
On the Review + create page, review the settings, and select Create.
-
-
After the deployment of the resource is successful, select Go to resource on the deployment page.
:::image type="content" source="./media/service-bus-create-namespace-portal/deployment-alert.png" alt-text="Screenshot showing the deployment succeeded page with the Go to resource link." lightbox="./media/service-bus-create-namespace-portal/deployment-alert.png":::
-
You see the home page for your service bus namespace.
:::image type="content" source="./media/service-bus-create-namespace-portal/service-bus-namespace-home-page.png" lightbox="./media/service-bus-create-namespace-portal/service-bus-namespace-home-page.png" alt-text="Screenshot showing the home page of the Service Bus namespace created." :::