# Limitations of using Branches

### About this export

| Field | Value |
| --- | --- |
| **content_type** | lesson |
| **platform** | contentstack-academy |
| **source_url** | https://www.contentstack.com/academy/courses/branches-foundations/limitations-of-using-branches |
| **course_slug** | branches-foundations |
| **lesson_slug** | limitations-of-using-branches |
| **markdown_file_url** | /academy/md/courses/branches-foundations/limitations-of-using-branches.md |
| **generated_at** | 2026-04-28T06:55:36.687Z |

> Part of **[Branches Foundations](https://www.contentstack.com/academy/courses/branches-foundations)** on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys.

<!-- ai_metadata: {"lesson_id":"10","type":"text","duration_minutes":1,"topics":["Limitations","using","Branches"]} -->

#### Lesson text

*   This feature will be plan-based.
    
*   The branch UID must be in lowercase, and only ‘\_’ can be used to separate two words.
    
*   The maximum number of branches allowed per stack will depend on the product tier.
    
*   Once you create a branch, you cannot edit its name or source branch.
    
*   The maximum character length for a branch ID is **15**
    
*   You cannot edit the name of the main branch.
    
*   You cannot delete a branch used as a source branch.
    
*   The Compare and Merge features are currently available only through CMA and CLI for the content type and global field modules only.
    

# **Limitations of Aliases**

*   This feature will be plan based.
    
*   The alias UID must be in lowercase 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 its 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**
    

# **FAQ**

Please take a moment to browse our Frequently Asked Questions (FAQ) for quick answers to common queries. Whether you're curious about branches, aliases, or services, our FAQ page provides comprehensive information to help address your concerns.

[Click here to explore our FAQ now](https://www.contentstack.com/docs/faqs#branches-faqs).

#### Key takeaways

- Connect **Limitations of using Branches** back to your stack configuration before moving to the next module.
- Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment.
- Re-read the delivery versus management boundary for anything you changed in the entry model.

## Supplement for indexing

### Content summary

Limitations of using Branches. This feature will be plan-based. The branch UID must be in lowercase, and only ‘\ ’ can be used to separate two words. The maximum number of branches allowed per stack will depend on the product tier. Once you create a branch, you cannot edit its name or source branch. The maximum character length for a branch ID is 15 You cannot edit the name of the main branch. You cannot delete a branch used as a source branch. The Compare and Merge features are currently available only through CMA and CLI for the content type and global field modules only. Limitations of Aliases This feature will be plan based. The alias UID must be in lowercase and only ‘\ ’ can be used to separate two words. The alias

### Retrieval tags

- Limitations
- using
- Branches
- branches-foundations
- lesson 10
- Limitations of using Branches
- branches-foundations lesson

### Indexing notes

Index this lesson as a primary chunk tagged with lesson_id "10" and topics: [Limitations, using, Branches].
Parent course slug: branches-foundations. Use asset_references URLs as thumbnail hints in search results when present.
Never surface LMS quiz content or assessment answers from this file.

### Asset references

_No image or video thumbnail URLs were extracted._

### External links

| Label | URL |
| --- | --- |
| Contentstack Academy home | `https://www.contentstack.com/academy/` |
| Training instance setup | `https://www.contentstack.com/academy/training-instance` |
| Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` |
| Contentstack documentation | `https://www.contentstack.com/docs/` |
| Click here to explore our FAQ now | `https://www.contentstack.com/docs/faqs#branches-faqs` |