Browse documentation

Create a Space

Create a Space and add the data objects, canvases and agents for a use case.

A Space groups the data objects, canvases, and agents for one use case so a team lands in the right place. For the mental model behind Spaces (what they are and when to reach for one), see Core concepts: Spaces. This page is the how-to.

Create a Space

  1. Open the Settings tab in the sidebar and go to Spaces (under Administration). You can also reach it from the Home tab with Manage spaces on the Spaces group.
  2. Click New.
  3. In the New space dialog, give it a name and an optional description, then click Create.
The New space dialog with a name and description field, and Cancel and Create buttons.
The New space dialog: name it, add an optional description, and click Create.

Set its icon, name and description

Open a Space from the Spaces list to edit it. The editor opens on the General tab, which has three fields:

  • Icon picks the symbol shown next to the Space.
  • Name is the label your team sees.
  • Description ("What is this space for?") is an optional line of context.
The General tab of the Space editor showing the Icon, Name and Description fields.
The General tab: set the Space's icon, name and description.

Add items

Switch to the Components tab. It has three sections, each with a + button:

  • Data objects for the objects this use case depends on.
  • Canvases for the dashboards that visualize them.
  • Agents for the agents configured for this use case.

Click + in a section and pick from the list. Added items appear as chips; use the × on a chip to remove one. Your changes are saved as you go.

The + button in a Components section opening a list of data objects to add, with existing items shown as chips.
Click + in a section and pick from the list. Added items become chips.

Where a Space shows up

Once a Space has items, it appears in two places in the Home tab: as its own group in the left sidebar (named after the Space), and as a block on the home overview. There's no separate Space page to open; instead you open an item from the Space and it takes you straight to that data object, canvas, or agent. An empty Space shows No items yet until you add something.

A Space shown as a block on the home overview, with cards for its data objects and agents.
On the home overview, a Space lists its items as cards you can open directly.

Where to go next