Spaces in Application Design Center provide isolated areas where teams
collaborate to create templates and deploy applications without affecting other
groups in your organization. Spaces are useful when you want to separate
team-specific configurations, experimental designs, and user permissions across
different teams or regions. Administrators can create and manage spaces across
regions, assign spaces to specific teams, and grant role-based permissions to
space members. Templates and applications remain isolated to their space unless
an administrator publishes the templates to a shared catalog.

## Before you begin

To perform the tasks in this document, ask your administrator to grant you the
necessary roles on the [app-enabled folder](https://docs.cloud.google.com/application-design-center/docs/key-concepts#app-enabled-folder) or [management project](https://docs.cloud.google.com/application-design-center/docs/key-concepts#mgmt-project), as listed in the following table:

| Task | Required roles |
|---|---|
| Select, view, and manage spaces across regional management boundaries | Application Design Center Admin (`roles/designcenter.admin`) |
| Perform initial setup or create new spaces | Application Design Center Admin (`roles/designcenter.admin`) |
| Manage space user permissions and assign IAM roles | Application Design Center Admin (`roles/designcenter.admin`) |

For more information about roles, see [Access control with IAM](https://docs.cloud.google.com/application-design-center/docs/access-control).

Before you manage spaces, do the following:

- Make sure that you have the [Application Design Center Admin
  (`roles/designcenter.admin`)](https://docs.cloud.google.com/application-design-center/docs/access-control)
  IAM role on the [app-enabled folder](https://docs.cloud.google.com/application-design-center/docs/key-concepts#app-enabled-folder) or [management project](https://docs.cloud.google.com/application-design-center/docs/key-concepts#mgmt-project).

- Complete the App Design Center
  [*initial setup*](https://docs.cloud.google.com/application-design-center/docs/setup) to create and name
  an initial space.

## Select a region

You created the following spaces when you set up App Design Center
in your [application management boundary](https://docs.cloud.google.com/application-design-center/docs/key-concepts#app-mgmt-boundary):

- A named *initial space*.
- A default space in each [region where App Design Center is available](https://docs.cloud.google.com/application-design-center/docs/locations).
- A space in a global region.

Each supported region in your application management boundary has a single
space. You can create templates, components, and application drafts in each
space. When application developers deploy these drafts, the application
continues to be managed from the originating space, but the underlying
Google Cloud resources can be provisioned in any supported region.

To select a region and view its templates, applications, and catalog, do the
following:

1. From the App Design Center navigation menu, click the
   **Region** list to view [regions where App Design Center
   is available](https://docs.cloud.google.com/application-design-center/docs/locations).

2. To open a region and view its space, click the region name.

3. To view a summary of your spaces across regions, from the **Region** list,
   select **Manage regions**.

   The number of templates and applications in each region is displayed. The
   table only includes regions that you've previously opened.
4. To view the resources in another region, in the **Actions** column,
   click **Switch to this region**.

## Create spaces to share catalogs

You can assign a development team to each space in your [application management boundary](https://docs.cloud.google.com/application-design-center/docs/key-concepts#app-mgmt-boundary).
However, you can't share a catalog between spaces in the same application
management boundary. You can only share a catalog with a destination space that
is in the same region as the source space, but located in a different
application management boundary.

To set up App Design Center in another application management
boundary with its own set of spaces, do the following:

1. In the Google Cloud console, select an [app-enabled folder](https://docs.cloud.google.com/application-design-center/docs/key-concepts#app-enabled-folder) or project
   that's not the same as the folder or project where you initially set up App Design Center.

2. Go to the **App Design Center Overview** page.


   [Go to Overview](https://console.cloud.google.com/products/design-center/overview)

   <br />

3. Complete the
   [App Design Center initial setup](https://docs.cloud.google.com/application-design-center/docs/setup)
   for the new folder or project.

   You can now [share a catalog](https://docs.cloud.google.com/application-design-center/docs/manage-catalogs#share-a-catalog-with-a-space) between spaces in distinct
   application management boundaries.

## Manage space users

Space users can collaborate to create templates and deploy applications.
You add each user or group as a principal, and then assign roles to
that principal to help them perform their duties. For example, you might assign
the Application Design Center Admin (`roles/designcenter.admin`) role to a
principal who needs to create and assign spaces, manage catalogs, and design
templates.

To manage space user permissions:

1. In the Google Cloud console, go to the **App Design Center
   Overview** page.


   [Go to Overview](https://console.cloud.google.com/products/design-center/overview)

   <br />

2. From the navigation menu, select a space from the **Space** list.

3. In the **Let your team use ADC** area, click **Manage permissions**.

4. Click **Add principal**, and do the following:

   1. In the **New principals** field, enter the principals that you want to
      add to the space.

   2. From the **Select a role** list, click **Other**.

   3. From the **Roles** area, select the role that you want to assign
      to the selected principals.

      For role descriptions, see [Access control with
      IAM](https://docs.cloud.google.com/application-design-center/docs/access-control).
   4. For each additional role that you want to assign to this principal,
      click **Add another role** and select a role.

   5. Click **Save**.

5. To assign access for additional users in this space, click **Add principal**
   and assign the relevant roles.

## What's next

- Define your own configurations by [designing application templates](https://docs.cloud.google.com/application-design-center/docs/design-application-templates).
- Share your templates with other spaces by [managing template catalogs](https://docs.cloud.google.com/application-design-center/docs/manage-catalogs).