---
title: "[Set Up Your Project] - Limitations of Aliases"
description: Limitations and rules for using aliases in branches.
url: https://www.contentstack.com/docs/developers/branches/limitations-of-aliases
product: Set Up Your Project
doc_type: reference
audience:
  - developers
version: v1
last_updated: 2026-03-26
---

# [Set Up Your Project] - Limitations of Aliases

This page lists the limitations and naming rules for branch aliases. Developers should read this when creating or managing aliases to ensure they meet product and plan constraints.

## Limitations of Aliases

- This feature will be plan based.
- The alias UID must be in lower case and only ‘_’ can be used to separate two words.
- The alias UID and branch UID cannot be the same.
- Once you create an alias, you cannot edit it’s name.
- The maximum number of aliases allowed per stack will depend on the product tier.
- The maximum character length for an alias name is **15**

## Common questions

### Can I change an alias name after creating it?

No. Once you create an alias, you cannot edit it’s name.

### What characters are allowed in the alias UID?

The alias UID must be in lower case and only ‘_’ can be used to separate two words.

### Can an alias UID match a branch UID?

No. The alias UID and branch UID cannot be the same.

### How many aliases can I create per stack?

The maximum number of aliases allowed per stack will depend on the product tier.