Skip to main content
An entity is a contact or an organisation record that a Space’s work is tracked against. When a Space declares one, every task, file and conversation under a contact’s folder is gathered in one place — instead of being scattered across the Space with no owner.
Not every Space has entities. Whether a Space anchors on a contact — and what it calls one — is set under Edit Space → Records → Base record. See Configuring a Space.

Contacts and organisations

A Space can declare up to two anchors: Each anchor points at one of the Space’s attached record configs, so the fields you fill in when creating one — and the schema they’re validated against — come from that config, not from a fixed form. Each also carries its own icon, shown wherever that kind of entity is listed: on its avatar, in the entity list, and above its folder.

Where entities show up

The Contacts panel

A Space with a contact anchor shows a panel in its panel row named after that record — Contacts by default, or whatever the Space calls one instead (for example, Clients) — see Menu and pages. What it looks like depends on whether the Space also declares an organisation:
One flat list of every contact in the Space. There is no organisation grouping.
When a column has more entries than fit, Show more loads the next set. The empty state names the contact or organisation label as configured for your Space, for example “No clients in this folder yet.” If the Space runs journeys, two chips filter the panel: Your turn shows the people waiting on you, and Waiting on (followed by the contact or organisation label) shows those you have handed on.
A Space clients page with a Clients card listing clients, a Start a journey button and Your turn and Waiting on chips, beside an All contacts card

The clients page at a Space root: clients on the left with Your turn and Waiting on chips, every contact on the right.

Contacts and organisations created before folder scoping existed still show up: they’re classified by the record config their folder marker points at, falling back to the old literal label it was created with. Nothing is lost by the switch to the newer panel.

A contact’s page

Opening a contact shows a header with the contact’s name and avatar, and the actions your Space has set up for a contact, such as creating a task or filing mail. Below it are the contact’s own pages.
  • A contact opens on its first client page, or on its Home, a page of cards for that one contact, when none is set. See Home and cards.
  • The other tabs, such as files, tasks and journey, are the client-level pages. Their order and which are on is set in the Space’s Pages and actions settings. See Menu and pages.
A client folder on its Home tab showing a Journey card with steps and several summary cards

A client's Home: its journey, then cards for that client only.

Start a journey

If the Space has a journey, a Start a journey button begins one for a contact. See Journeys.

The Folder field on a task

A task’s Folder field is a picker of the Space’s contacts — not a filing tree. Assigning a task to a contact’s identity (an email address, for example) files it under that contact automatically. See Folders and contacts for the full behaviour, including what happens when the link can’t be made.

Creating a contact

From the Contacts panel (or the client actions menu on the Files and Tasks panels), choose New <contact label>. The form is generated from the Space’s base record configuration, so the fields you see match whatever schema that config defines. Creating a contact:
  • Mints the contact’s own folder, keyed on its identity fields (the fields the Space uses to tell one contact from another — usually an email address).
  • Does not, by itself, give the contact a sign-in to the client portal. That’s a separate, deliberate step — see Client Portal.
If the Space declares an organisation, a New <organisation label> option creates one the same way, using the organisation record’s own configuration and identity fields.
A contact filed under an organisation is created from inside that organisation’s folder, or by picking the organisation on the contact’s own form — whichever the Space’s layout offers.

Searching and filtering

The folder-scoped panel has its own search box, scoped to the folder you’re in — it matches contacts and organisations filed there, not the whole Space. Clearing the search returns to the full listing for that folder.

Spaces Overview

Setting a Space’s base record and organisation record.

Cases

The pieces of work held under a contact.

Tasks

How a task’s Folder field relates to contacts.

Client Portal

Giving a contact a sign-in, and what they see once they have one.

Records

The record sets a Space attaches, including the ones its entities are built from.