Space Creation Manual
Toshi Dávila avatar
Written by Toshi Dávila
Updated over a week ago

An Assembla "Space' is a team workspace, typically representing one project. In a space, you could do all sorts of things from tracking your team activity, brainstorming for new ideas, planning and deploying releases, managing code, managing your team, to communicating with your customers.

All spaces will have team and stream tools pre-installed, but if you want to add any other Assembla Tools to the space, visit the Admin-Tools page (go to your space -> select the 'Admin' tab -. select Tool). You could set up as many or as few spaces as you want.

How to Create a Space?

After login, navigate to your start page (https://app.assembla.com/) and click on the green (+) button and then “Create New Space” to bring up the window below.

Name your Space with a unique name. If the Space name is already taken, please use a different name.

Once you have named your Space, choose your set of tools.

If you would like to add/remove repositories or tools to your Space at any point, please go to your Space's Admin > Tools page. You can do so by going into your Space, clicking the Admin tab, clicking Tools, and clicking on the 'Add' button next to the tool you would like to add.

Note: If you are not the owner or payer of the space, you will not have access to your Space's Admin tab.

For Users with the New UI

How to Create a Space?

After logging in, you can either click on the green (+) button and then Create New Space or you can select Create New Space from your Portfolio home page.

Name your Space with a unique name. If the Space name is already taken, please use a different name.

Once you have named your Space, choose your set of tools.

If you would like to remove repositories or add or remove other tools to your Space at any point, please go to your Space's Admin > Tools page. You can do so by going into your Space, clicking the Admin tab, clicking Tools, and clicking on the Add button next to the tool you would like to add.

Note: If you are not the owner or payer of the space, you will not have access to your Space's Admin tab.

About space prefix

Each space has a unique name and a unique prefix. The space prefix is a unique code that identifies the space and becomes the first part of that ticket ID (BR-1, BR-2, for example). We automatically generate a prefix when the space name is created.

Adding a Repository to Your Space

When creating a new Space, you can create the Space with a repository by checking the Create with repository box on the first step.

Alternatively, if you would like to create a repository in an existing Space, click on the green (+) button and select New Repository. The wizard will ask you to select the Space you would like to create your repository in, as well as what you would like to name your repository and what type of repository it is.

If you would like to import an existing repository from an external location, select Import repository and enter your repository's URL and, if necessary, access credentials.

How to Configure and Customize Your Space?


You can configure and customize a space if you are an owner/payer of the space (you can check your role by going to the ‘Team’ tab). You could also edit the space if your user-role has access to ‘ALL’ permissions (you’ll know if you could see the ‘Admin’ tab). Keep in mind that when you change settings as an ‘Admin,’ you are changing the settings of the space for the whole team.

Go to the ‘Admin’ page of your space. It should look like the image below.

Admin - Tools
In this page, you could easily add or remove any Assembla Tools to your space as desired.

Admin - Appearance
In this page, you could change the name and url of your space, change the looks of your space, change the ordering of your Tabs in the Navigation bar, and change the landing pages for your team.

Admin - Security
In this page, you can set the custom permissions for ‘Team Members, Watchers, and Non-members.’ For each user-role, they will have the permission to either Edit, View, or All (Edit and View). These are the recommended settings and the users that we kept in mind, when creating the roles.

Team Members (Edit): People who have work to do on the project(s) in the spaces. They can edit most aspects, but do not have the power to delete things. Only the ‘owner’ of the space can delete things unless you choose ‘All’ permissions here.

Watchers (View): The set of people like clients, investors, or other people who want to see your work, but may not have an Assembla account. They can see your work, and can submit tickets for bug fixes or feature requests.

Non-member (View): Members of the Assembla community who have accounts, but are not part of your space. If you have a private space, you can lock these people out entirely. Having private and public spaces allows you to have an additional layer of security between you and your fellow ‘Assemblers.’ 

Note: Spaces are set to 'private' by default

Admin - Email Alert Settings for New Team Members

By default, new users will receive some email alerts. The Email Alert Setting option in the Admin page controls the alerts users receive when they are first invited. Every user can change his alert settings by going to the Stream-Email Notifications page in the space. Set email alerts for events you think will be important for your team to hear about.

Have questions? Email us support@assembla.com

Did this answer your question?