> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promptr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizing with Spaces

> Use spaces to group and manage your blocks by project, topic, or team.

Spaces are containers for blocks. You might create one space per project, one per client, one for personal prompts, and one for shared team instructions. Every block lives inside exactly one space.

<Note>
  **Shared vs. private spaces:** Shared spaces are visible to other workspace members you invite (or to everyone, if you enable the "Share with everyone" toggle). Private spaces are only accessible to you. Other members cannot see their contents, even if they're in the same workspace. Use private spaces for personal prompts and drafts, and shared spaces for team-wide context and instructions.
</Note>

***

## Create a new space

1. Click **New space** in the sidebar (or navigate to **All spaces** and click **New**).
2. Give the space a **name**. It appears in the breadcrumb and in the extension's [Browse tab](/guides/using-the-extension#browse-tab).
3. Optionally add an **emoji icon** by clicking the icon area next to the name. The emoji shows up on space cards and in the extension sidebar.
4. Optionally add a **description**: a short sentence explaining what this space is for.
5. Choose **Shared** or **Private** as the space type.

The space is created immediately and you land in the empty state, ready to add your first block.

***

## Add blocks to a space

From inside a space, click **Add new** in the filter bar. The new block is automatically assigned to the current space.

You can also move an existing block from another space into this one. See [Moving blocks between spaces](#moving-blocks-between-spaces) below.

***

## Share a space with your workspace

To make a shared space visible to everyone in your workspace:

1. Open the space and click **Share** in the top-right header.
2. Switch to the **Workspace** tab in the share panel.
3. Check **Share with everyone**. All current and future workspace members will have access automatically.

To invite specific people instead, stay on the **Invite** tab, enter their email address, and click the invite button. You can also toggle individual workspace members on and off from the Workspace tab's member list.

***

## Make a space private

To convert a shared space to private, click **···** (the actions menu) in the space header and select **Make private**. Promptr will ask you to confirm, since this removes access for all current members.

Private spaces show a lock icon in the breadcrumb and in the sidebar. Only you can view and edit their contents.

***

## Filter blocks within a space

The filter bar above the block grid lets you narrow down which blocks are shown:

<CardGroup cols={2}>
  <Card title="By type" icon="shapes">
    Filter by **Context**, **Instruction**, or **Prompt** to focus on one kind of block.
  </Card>

  <Card title="By tag" icon="tag">
    Select one or more tags to show only blocks with those labels.
  </Card>

  <Card title="By creator" icon="user">
    In shared spaces, filter to blocks created by a specific team member.
  </Card>

  <Card title="By search" icon="magnifying-glass">
    Use the search box on the right side of the filter bar to find blocks by title or content within the current space.
  </Card>
</CardGroup>

You can combine multiple filters at once. Click **Clear** next to the active filters to reset.

### Sorting

Click the sort button (shown with the currently active sort field) to change the sort order. Available options:

* **Name:** alphabetical
* **Block type:** grouped by context, instruction, or prompt
* **Date created**
* **Last modified**
* **Most used:** sorts by usage count, highest first

Toggle **Ascending** or **Descending** within the sort menu.

***

## Space views: Cards and Table

Use the **Cards** and **Table** toggle in the top-left of the filter bar to switch between views.

<Tabs>
  <Tab title="Cards view">
    Displays blocks as a responsive grid of cards. Each card shows the block's icon, title, description, tags, creator avatar, and usage count. Cards view is ideal for browsing and visually scanning a space.
  </Tab>

  <Tab title="Table view">
    Displays blocks as a dense, resizable table with sortable columns. Table view is ideal for bulk operations. Select multiple blocks using checkboxes, then move or delete them all at once using the bulk action bar that appears at the top.

    You can resize columns by dragging the column dividers, and show or hide specific columns using the **Properties** dropdown on the right side of the filter bar.
  </Tab>
</Tabs>

***

## Moving blocks between spaces

**Single block:** Open the block, click the **···** actions menu, and select **Move**. Choose the destination space from the picker.

**Multiple blocks:** Switch to **Table** view, check the boxes next to the blocks you want to move, then click **Move** in the bulk action bar. A modal lets you select the destination space.
