Mastering Confluence Space Name Restrictions: Rules, Limits & Best Practices
19.12.2022 ... Yes, while the Space key is unique, Space name need not be unique even when importing the Confluence space. You can create different spaces with ...
Understanding confluence space name restrictions is essential for any team standardizing their documentation environment. These rules, defined by the platform's underlying architecture, dictate what characters and formats are permissible when labeling a space. Getting this wrong during setup can lead to broken links, difficult navigation, and a frustrating experience for every user interacting with the workspace.
Why Name Restrictions Matter
At first glance, confluence space name restrictions might seem like arbitrary technical hurdles. In reality, they are the guardrails that ensure structural integrity across the platform. A space name functions as a unique identifier within the URL structure, powering the backend logic that routes users to the correct location. If special characters or spaces were allowed, these URLs would become malformed, causing 404 errors and loss of data accessibility. The restrictions are in place to maintain a stable and reliable system for enterprise collaboration, ensuring that every link shared remains a permanent pointer to the correct destination.
The Core Character Limitations
When creating a new space, users must adhere to strict character rules. Generally, the name can include letters, numbers, and spaces. However, the use of punctuation is strictly limited. You cannot use symbols such as exclamation points, ampersands, or forward slashes within the display name. Furthermore, the name cannot begin or end with a space, nor can it contain consecutive spaces. These limitations are enforced to prevent parsing errors in the system’s database and to ensure the visual consistency of space listings across the user interface.
Technical Structure and URL Safety
Behind the scenes, confluence converts the display name into a "space key," which is the actual URL handle. This process involves stripping out illegal characters and often converting the text to lowercase. For example, a name like "Q3 Sales & Marketing" cannot be used because of the ampersand. The system might force the name to become "q3-sales-marketing" to ensure the URL is safe for HTTP requests. Understanding this conversion process helps teams choose names that will translate cleanly into web addresses, avoiding confusion between the human-readable title and the machine-readable key.
| Character Type | Allowed | Example |
|---|---|---|
| Uppercase Letters | Yes | Marketing |
| Lowercase Letters | Yes | marketing |
| Numbers | Yes | 2024 |
| Spaces | Yes (Single) | Project Plan |
| Symbols ( ! @ # $ % ^ & * ) | No | Invalid |
| Punctuation ( , . ; ) | Generally No | Marketing, fails |
Best Practices for Naming
To avoid running into confluence space name restrictions mid-project, planning the name in advance is crucial. The most successful teams opt for descriptive yet simple titles. Using camel case or underscores can be a workaround to create readability without violating character rules, though spaces remain the most user-friendly option for clarity. It is also wise to avoid overly generic names that might conflict with existing macros or templates within the instance. A unique name reduces the risk of duplicates and keeps the space hierarchy organized from the start.
Migration and Future Proofing
Changing a space key after content has been created is a complex process that often requires administrative intervention and can break external links. Therefore, getting the name right the first time is significantly easier than migrating data later. Teams should consider how the space will appear in the global navigation and how the URL will be shared with external stakeholders. By aligning the confluence space name restrictions with standard branding guidelines, organizations can ensure that their digital infrastructure remains scalable and that links retain their integrity over the lifespan of the product.
<strong>Duplicate Space name allowed? - Confluence - Atlassian Community</strong><p>19.12.2022 ... Yes, while the Space key is unique, Space name need not be unique even when importing the Confluence space. You can create different spaces with the same name.</p>
<strong>Create a space | Confluence Cloud - Atlassian Support</strong><p>No more than 255 characters in length. App admins can edit an existing space key. Next to your space's name in the sidebar, select More actions (•• ...</p>
<strong>Page Naming Conventions for Better Searchability in Confluence</strong><p>04.02.2026 ... "Sorry, what was the name of that page again?" Here are some tips to help make sure your Confluence pages are found quickly and navigated in ...</p>
<strong>Unique page names in space limitation | Confluence Data Center</strong><p>+20 for duplicate page names per space. Our department has been using DekiWiki for a while, but now the company as a whole is moving to confluence, we now find ...</p>
<strong>Space naming convention | Confluence Data Center</strong><p>27.03.2025 ... Create a way to apply naming conventions to space names so that users can only create spaces with names that follow the convention.</p>
<strong>How Configure Confluence Space Permissions - YouTube</strong><p>13.10.2022 ... In this video, you will learn how to setup #Confluence #Space #Permissions. Every space in Confluence can have its access managed.</p>
<strong>Allow special characters in labels and spaces | Confluence Cloud</strong><p>NOTE: This suggestion is for Confluence Cloud. Using Confluence Server? See the corresponding suggestion. The set of special characters that are not allowed in ...</p>
<strong>Change the space name and logo | Confluence Cloud</strong><p>Step-by-step instructions for how to change the space name and logo as a space admin ... Bypass page restrictions with admin key · Manage global permissions in ...</p>
<strong>Enable creation of same-named pages within a space | Confluence ...</strong><p>Wiki page names must be unique within a space. This makes organization painful if a space contains similar topics, e.g. "Meeting" pages for multiple teams or ...</p>
<strong>How to create a Confluence space in 3 simple steps - Kolekti</strong><p>Click on 'Spaces' in the sidebar. In the dropdown, select 'Create a space'. Fill in the details for your new space, including its name, icon, and purpose.</p>
<strong>HTML for Confluence</strong><p>Due to restrictions in Confluence cloud, the HTML macro name must be changed to HTML-bobswift. ... spacekey FROM CONTENT c JOIN BODYCONTENT bc ON c.contentid ...</p>
<strong>Confluence - Uni Münster</strong><p>Please provide the following information: the desired name of the space; an space abbreviation that will later appear in URLs (at least 3-6 characters, only ...</p>
<strong>Confluence (BayernCollab) - LMU Munich</strong><p>User name: LRZ ID (see user account, you can find your LRZ identifier directly in the upper section above the tiles). Password: Password of the LMU user ID ...</p>
<strong>Allow creation of page with the same name within the same space</strong><p>Due to current unique name restriction, we can not repeat the customer name ... What about Confluence allowing to save internally the page name adding ...</p>
<strong>Restrict MCP to certain spaces and projects · Issue #79 - GitHub</strong><p>24.02.2026 ... ... Confluence spaces, specially in big organizations ... Ability to provide a Edit Restricted Confluence Project List where all matching projects ...</p>
<strong>FAQ - Issue with module name - Page with such a title already exists ...</strong><p>When you create a new module, a new Confluence page is added. A module name becomes a page title. Confluence allows only unique page titles in a space. If ...</p>
<strong>The complete guide to page permissions in Confluence - AppFox</strong><p>17.04.2024 ... From space permissions to individual page restrictions, you can choose how to lock down and protect your content. And we're here to guide you through.</p>
<strong>Index your Atlassian Confluence Cloud contents using the Amazon ...</strong><p>22.08.2024 ... _group_ids – Group names are present on spaces, pages, and blogs where there are restrictions. They're mapped from the name of the group in ...</p>
<strong>publishToConfluence - docToolchain</strong><p>23.03.2022 ... ancestorName (optional): the name of the parent page in Confluence ... If you are restricted and can't create new spaces, you can use ...</p>
<strong>Confluence space export and import guide - Facebook</strong><p>03.10.2024 ... Click on the space name in the top left (or use the space sidebar) ... - Can I limit the records that can be exported according to the assigned ...</p>
