Spaces in CodeCatalyst - Amazon CodeCatalyst

Spaces in CodeCatalyst

You create a space that represents you, your company, department, or group, and provides a place where your development teams can manage projects. You must create a space to add projects, members, and the associated cloud resources you create in Amazon CodeCatalyst.


Space names must be unique across CodeCatalyst. You cannot reuse names of deleted spaces.

When you create a space, you are automatically assigned the Space administrator role. You can add this role to other users in the space.

With the Space administrator role, you can manage the space as follows:

  • Add other space administrators to the space

  • Change member roles and permissions

  • Edit or delete the space

  • Create projects and invite members to the project

  • View a list of all projects in the space

  • View the activity feed for all projects in the space

When you create a space, you are automatically added to the space with two roles: the Space administrator role, and the Project administrator role for the project you created as part of creating the space. Additional users are added as members to the space automatically when they accept invitations to projects. This membership in the space does not grant any permissions in the space. What users can do in a space is determined by the role the user has in a specific project.

For more information about roles, see Working with roles in Amazon CodeCatalyst.

      Diagram showing how spaces share members and resources across projects while all
        projects return activity data to the space level

The following are additional considerations for added accounts:

  • There is a one-to-one mapping of account connection to AWS account for a space. A single AWS account can be added to multiple different spaces. AWS accounts you deploy to do not need to be unique and can be used by more than one space.

  • AWS accounts added to a CodeCatalyst space can be used in any project in that space.

  • While each environment can support multiple AWS accounts, you can only use one account per environment in an action.

  • Billing is configured at the space level. Multiple accounts can be configured for billing, but only one can be active in a CodeCatalyst space. Only one AWS account can be used as a billing account for a space in CodeCatalyst. If an account is already used for a space, you must use a different billing account for the additional space.

  • After you create a connection, you must add AWS IAM roles to your connection if your workflow must access those IAM roles with your CodeCatalyst environment. For more information about how environments are used, see Working with environments.