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

# Spaces

> A Space is where you collaborate with the people you invite.

export const SpacesPageFaq = () => <AccordionGroup>
    <Accordion title="Who can invite someone to a Space?">
      An <strong>Admin</strong> can invite a contact. Any member can add a document and share one of their Personas. Adding someone in <a href="/using-webai/contacts">Contacts</a> does not put them in a Space.
    </Accordion>
    <Accordion title="Where does a shared Persona run?">
      A Persona shared into a Space still runs on the device of the person who shared it. A message, a file, and a Persona call move between the devices of people in the Space.
    </Accordion>
    <Accordion title="What is Shared knowledge?">
      <strong>Shared knowledge</strong> is where members add documents for the Space. People collaborating in the Space can search those files. If this device cannot search Space Knowledge locally, use an online paired device that can, or connect a Persona and tag it.
    </Accordion>
    <Accordion title="What is the difference between Ask and a channel?">
      A <strong>channel</strong> is where people collaborate in the Space. <strong>Ask</strong> is for a question with the group, not a private chat and not a channel message. Type <strong>@</strong> to call a connected Persona in either place when that Persona is available.
    </Accordion>
  </AccordionGroup>;

Open **Spaces** in the left sidebar to make one, invite people, and work in it together. A question can use files the group added, or a Persona a member connected. That Persona still runs on that member's device.

<Info>
  Spaces use webAI's peer-to-peer connection. The people in a Space work from their own devices. A message, a file, and a Persona call move between those devices.
</Info>

<CardGroup cols={2}>
  <Card title="Invite people" icon="user-plus">
    Bring someone in from Contacts so they can collaborate here. They join when you click **Invite**.
  </Card>

  <Card title="Talk in a channel" icon="hashtag">
    Collaborate in a channel. A message is copied onto the devices of the people in the Space. Type @ to call a Persona there.
  </Card>

  <Card title="Ask in the Space" icon="sparkles">
    Ask with the group, not in a private chat and not in a channel. Tag a connected Persona with @ when you want that Persona to answer.
  </Card>

  <Card title="Share a file" icon="book-open">
    Add a document on **Shared knowledge**. People collaborating in the Space can search it.
  </Card>
</CardGroup>

## Create a Space

<Steps>
  <Step title="Open Spaces">
    Click **Spaces** in the left sidebar.
  </Step>

  <Step title="Start a new one">
    Click **New space**.
  </Step>

  <Step title="Name it">
    Give it a **Space name**. **Create** stays off until the name has text. **Description** is optional.
  </Step>

  <Step title="Create it and open it">
    Click **Create**. The Space is on the list. Click it to open it. The sidebar has **Overview**, **Ask anything**, **Shared knowledge**, and **Connected personas**, plus **Channels**.
  </Step>
</Steps>

### Overview

**Overview** lists the people in the Space. A role reads **Member** or **Admin**.

<Note>
  An Admin can invite a contact. Any member can add a document and share one of their Personas. An Admin can also remove a file or a Persona connection that someone else added.
</Note>

If you are an Admin, open a member's options to set **Member** or **Admin**, or click **Remove from space**. Removing them takes away their access. You can invite them again later. Your own row does not have that menu. Leaving is the way out for you.

### Ask anything

**Ask anything** is a question you ask with the Space, not a private chat and not a channel message.

<Tabs>
  <Tab title="No tag">
    Send the question with no @. Space Knowledge searches the shared files on the device that is answering. Channel messages are searched too.

    One connected Persona may be added if its name and description fit the question and the person who shared it is online. If none fit, no connected Persona is added. Space Knowledge still answers.

    Open **Sourcing complete** under the reply. **Connected persona**, **Space persona**, and **Thread search** show what was used. **Space persona** is the file search. **Thread search** is the channel messages. **Processed on** names the device that searched the files.
  </Tab>

  <Tab title="You pick a Persona">
    Type @ and pick a connected Persona. That Persona answers. The automatic pick does not run. The question goes to the device of the person who shared it.
  </Tab>
</Tabs>

<Note>
  If a notice says this device cannot search Space Knowledge locally, bring an online paired device that can, or connect a Persona and tag it. **Web search** shows **On**, **Off**, or **Unavailable**. Unavailable means there is no connection. Search resumes when you reconnect.
</Note>

### Shared knowledge

Any member can click **Add document** and choose files. Each member's device builds its own searchable copy. A question searches the copy on the device that is answering.

If a notice says this device does not index files, you can still add them. They can be downloaded. This device will not search them. Search then needs an online paired device that can. You can remove a file you added. An Admin can remove any file. **Remove** takes it off Shared knowledge for everyone in the Space. You can add it again later.

### Connected personas

Any member can click **Share persona** and pick one of theirs. The menu lists Personas on this device. A Persona someone else already connected is not in that menu.

Sharing a Persona connects it to the Space. It does not copy the Persona onto anyone else's device. The instructions stay on the device of the person who shared it, and that is where the answer is produced. If that person is offline, other members see the host as offline and the call does not run.

You, or an Admin, can click **Remove from this space**. That takes the connection away for everyone. The Persona stays on the device that shared it. You can share it again later.

## Channels

A channel is where the people in the Space collaborate in writing. Under **Channels**, click **Add**, type a name, and press Enter. Click the channel to open it. The breadcrumb with the Space name closes the channel and returns you to the section you were on.

### Where channel messages live

A message you send is copied onto the devices of the people in the Space. It is not kept only on the device that sent it. A reply in a thread is stored the same way. Someone who joins later can read that channel history on their device. A person who is offline gets those messages after they reconnect.

<Note>
  If you leave and other people stay, they still have the messages their devices already received. This device drops its copy, and you lose access to the channels. A message that never reached anyone else goes with that copy. If you are the only member, leaving removes the Space, including its channels and messages.
</Note>

### Call a Persona in a channel

Type @ in the channel message box and pick a Persona from the list. The list is your Personas and the Personas connected to the Space. Sending that message calls the Persona. The reply is posted in the channel, so the people in the Space see it.

<Steps>
  <Step title="Open a channel">
    Click the channel under **Channels**.
  </Step>

  <Step title="Tag a Persona">
    Type @ and pick a Persona from the list. Typing @ without picking from the list does not call anyone.
  </Step>

  <Step title="Send it">
    Send the message. The reply is posted in the channel.
  </Step>
</Steps>

<Note>
  A connected Persona still runs on the device of the person who shared it. If that person is offline, the call does not run. A Persona of yours runs on your device. The reply is still posted in the channel. The same @ pick works when you reply in a thread.
</Note>

## Invite a contact

**Invite contact** is on an open Space when you are an Admin. It lists people in [Contacts](/using-webai/contacts) so they can collaborate in this Space. It does not add a new person.

<Steps>
  <Step title="Open the list">
    Click **Invite contact**.
  </Step>

  <Step title="Invite them">
    Click **Invite** next to a person. They join the Space. You do not send a code.
  </Step>
</Steps>

<Note>
  If the list is empty, add someone in Contacts, then come back. A row that says **Already a member** is already in the Space. A row that says **No IDN identity yet** still needs pairing. That pairing is done in Contacts, not here.
</Note>

<Info>
  Contacts is where you add a person. A Space can invite that person after they are there. Adding someone does not put them in a Space.
</Info>

## Leave or delete a Space

Open the options on an open Space, or on its card in the list.

**Leave space** removes your access. An Admin can invite you back. If you are the only member, leaving removes the Space. If you are the only Admin and other people are still in it, the prompt says **Make another admin first**. Make someone else an Admin from **Overview**, or delete the Space.

**Delete space** is there when you are an Admin. It removes the Space for every member, including its channels and messages. That cannot be undone.

### If you leave

<Tabs>
  <Tab title="This device">
    You lose access to the Space, including its channels. This device drops its copy of those messages, its searchable copy of the Space's files, and the copies it downloaded. A Persona you shared is not deleted from your Personas list.
  </Tab>

  <Tab title="People who stay">
    They still have the channel messages their devices already received. A file you added stays in the Space until someone removes it. A Persona you connected can stay listed until someone clicks **Remove from this space**. Calls to it stop, because your device has left and no longer answers for this Space.
  </Tab>
</Tabs>

### Bookmark a Space

Click the bookmark on a Space to mark it as saved, so you can find it again. That does not invite anyone. Open the filter and choose **Saved first** or **Saved only**. Click the search icon and type a name to look one up.

## Common questions

<SpacesPageFaq />