Management and governance sub

Subscription naming convention

The CAF abbreviation for Subscription is sub. Names can be 1 to 64 characters long and allow alphanumerics, hyphens and underscores. The name must be unique within the tenant.

Naming rules

CAF abbreviation	sub
Length	1 to 64 characters
Allowed characters	Alphanumerics (a-z, A-Z, 0-9), hyphens, underscores
Scope of uniqueness	Unique within the tenant
CAF pattern	sub-{workload}-{environment}-{region}-{instance}

Worth knowing: Not a formal ARM resource, Microsoft defines no naming rules. Display names allow up to 64 characters. "sub" is a common community convention, not an official CAF abbreviation.

Rules follow Microsoft's resource naming rules and CAF abbreviations. Some resource types have extra start/end character restrictions, so verify against the official docs before locking in a convention.

Example names

Generated by the same engine as the name generator, so length and character rules are already applied.

Scenario	Generated name	Length
Payments API, production	`sub-payments-prod-eus-001`	25/64
Web app, development	`sub-webapp-dev-weu-002`	22/64
Analytics with company prefix	`sub-contoso-analytics-stage-uks-001`	35/64

Naming in Terraform and Bicep

Build the name from variables so one module produces the right name in every environment.

Terraform

locals {
  subscription_name = "sub-${var.workload}-${var.environment}-${var.region}-001"
}

Bicep

var subscriptionName = 'sub-${workload}-${environment}-${region}-001'

Generate Subscription names for your workload

Free, no login. Validation and Terraform, Bicep, or CSV export included.

Open in the generator →

Related Management and governance resources

aa Automation account policy Azure Policy definition appi Application Insights ag Azure Monitor action group dcr Azure Monitor data collection rule apr Azure Monitor alert processing rule dce Data collection endpoint script Deployment script

See the full list of Azure resource naming rules or read the complete CAF naming guide.