Enforce naming conventions

Naming conventions help IT administrators and users:

• assign workspaces to an area
• recognise their purpose
• find them more easily

With rules for display name, email address and site URL, you enforce your requirements consistently per template.

Common naming conventions

These patterns are often used in practice:

Prefix

	Rule	Result
Display name	{{name}}	Marketing
Email address	org-{{name}}	org-marketing@contoso.com
Site URL		…/sites/org-marketing or …/teams/org-marketing

Project number

	Rule	Result
Display name	{{projectCode}} - {{name}}	26016 - ERP rollout
Email address	{{projectCode}}	26016@contoso.com
Site URL		…/sites/26016 or …/teams/26016

Customer number

	Rule	Result
Display name	{{customerNumber}} - {{customer}}	10234 - Example Ltd
Email address	cst-{{customerNumber}}	cst-10234@contoso.com
Site URL		…/sites/cst-10234 or …/teams/cst-10234

Set up a naming convention

Prefix

1. Open Groups → Templates → organisation → template → Naming.

2. Under Display name format, enter {{name}}.

   {{name}} is the name the user enters.

3. Under Group email and site-url format, enter org-{{name}}.

4. Save the template.

Project number

1. Open Groups → Templates → organisation → template → Naming.

2. Under Custom fields, click Add field and enter:

   • Name: Project code
   • Hint: Enter the 5-digit project code.
   • Validation: ^[0-9]{5}$

   The key projectCode is generated from the name.

3. Under Display name format, enter {{projectCode}} - {{name}}.

4. Under Group email and site-url format, enter {{projectCode}}.

5. Save the template.

Customer number

1. Open Groups → Templates → organisation → template → Naming.

2. Under Custom fields, click Add field and enter:

   • Name: Customer number
   • Hint: Enter the 5-digit customer number.
   • Validation: ^[0-9]{5}$

3. Add a second field:

   • Name: Customer
   • Hint: Enter the customer name.

4. Under Display name format, enter {{customerNumber}} - {{customer}}.

5. Under Group email and site-url format, enter cst-{{customerNumber}}.

6. Save the template.

Recommendations

• Define the email address and site URL carefully before use. Owners and admins can change the display name later.
• Separate placeholders with - or brackets. Otherwise Microsoft 365 search does not reliably find partial terms.
• Keep site URLs short. Long paths hit limits with OneDrive sync.
• Use a prefix such as prj-. This lets you recognise the template in the Microsoft admin centers.
• Use only lowercase letters, numbers, hyphens and dots for email address and URL.

Note

For workspaces created via the Seamless API, Seamless does not apply the naming convention. The calling system passes the display name and mail nickname as final values.

Next steps

VisibilityDefine public or private workspaces

Learn more

Create a workspace (API)POST /teams