> For the complete documentation index, see [llms.txt](https://docs.courtaid.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.courtaid.ai/matter-workspaces/matters.md).

# Matters

Matters let you organise legal documents, combine your own files with CourtAid's court database, and run matter-specific AI chat across everything in one place.

{% hint style="info" %}
Matters were previously called **Projects**. If you see "project" in an older guide or email, it means the same thing.
{% endhint %}

![My Matters page](https://1143104512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoFACnrJdsxVDAKioc81%2Fuploads%2Fgit-blob-9f1c4c928305798ddabbd3c9c9689f52d77dfca4%2Fmatters-page.png?alt=media)

## What is a matter?

A matter is a workspace for a client file, case, or research topic. Each matter can contain:

* **Your uploaded documents** — pleadings, correspondence, contracts, evidence
* **Saved court decisions** — cases you save from Search results
* **Matter chat** — AI conversations scoped to the matter's documents plus CourtAid's database
* **Chronologies** — timelines built from the matter's documents
* **Tabular reviews** — structured data extraction across documents
* **Drafts** — documents written with the [Document Drafter](https://docs.courtaid.ai/chat-and-documents/document-drafter.md)

Think of a matter as a folder that also lets you chat with its contents.

## Creating a matter

### From the Matters page

1. Go to **Matters** in the sidebar
2. Click **New Matter**
3. Fill in the details:
   * **Matter Name** (required) — e.g. *"Smith v Jones – Contract Dispute"*
   * **Description** (optional) — brief summary of the matter
   * **Client name** and **Client ID** (optional) — your client and internal client reference
   * **Case ID** (optional) — your external case or file number
   * **Board** (optional) — which board the matter appears on in Board view
4. Click **Create Matter**

### From the landing page

Click the **New Matter** button below the main chat input.

### From chat

Click the **+** button (upload/attach) on the chat input and choose to create or select a matter.

## Managing matters

The **My Matters** page shows all your matters.

### Finding matters

* **Search** — type in the search bar and choose whether to match on **Name**, **Client ID**, or **Case ID**
* **Sort** — sort by date, name, Client ID, Case ID, or board
* **Columns** — show or hide the Client ID, Case ID, Board, and Stage columns
* **List / Board** — switch between a table of matters and a board of cards grouped into stage columns

### Per-matter actions

Each matter row has quick-action buttons:

| Button         | Action                                        |
| -------------- | --------------------------------------------- |
| **Upload**     | Add files to this matter                      |
| **Chat**       | Start a chat scoped to this matter            |
| **Chronology** | Generate or view a chronology for this matter |
| **⋮** (menu)   | View files, share, edit, or delete the matter |

Click the matter name or expand the row (▸) to see files inside.

### Loose Files

**Loose Files** is a default matter for documents uploaded without a specific matter. You can't delete it, but you can move files from Loose Files into named matters.

## Matter workspace

Click a matter name to open its **matter workspace**. Everything relating to that matter lives in one place.

![Matter workspace tabs](https://1143104512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoFACnrJdsxVDAKioc81%2Fuploads%2Fgit-blob-77a5def260329ed30777d3b217f1b8bfdfa16e63%2Fmatter-workspace-tabs.png?alt=media)

### Workspace tabs

Every matter has its own set of tabs:

| Tab              | Purpose                                                                                                                                   |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **AI Assistant** | Chat scoped to this matter's documents plus CourtAid's court database                                                                     |
| **Chronologies** | Build and view event timelines from the matter's documents                                                                                |
| **Tabular**      | Run [Tabular View](https://docs.courtaid.ai/matter-workspaces/tabular-view.md) reviews across the matter's files                          |
| **Drafts**       | Draft documents grounded in this matter's files — see [Document Drafter](https://docs.courtaid.ai/chat-and-documents/document-drafter.md) |
| **Chat history** | Browse past conversations for this matter only                                                                                            |

This means each matter keeps its own chat, chat history, tabular reviews, chronologies, and drafts — separate from other matters.

Use the **+ Chat** button to start a new conversation within the matter.

### What's in a matter workspace

| Feature         | Scoped to this matter                               |
| --------------- | --------------------------------------------------- |
| Uploaded files  | Yes — shown in the matter files panel               |
| AI chat         | Yes — searches your files + CourtAid's 2M+ database |
| Chat history    | Yes — only conversations for this matter            |
| Tabular reviews | Yes — tables built from this matter's documents     |
| Chronologies    | Yes — timelines from this matter's documents        |
| Drafts          | Yes — drafts linked to this matter                  |

### Navigating between tabs

Switch tabs at the top of the workspace without losing your place. For example:

1. **Upload** documents on the AI Assistant tab
2. Switch to **Tabular** to extract key fields across all files — see [Tabular View](https://docs.courtaid.ai/matter-workspaces/tabular-view.md)
3. Switch to **Chronologies** to build a timeline of events
4. Return to **Chat history** to pick up a previous conversation

## Sharing a matter

If you belong to an organisation, you can share a matter with colleagues in it:

1. On the **My Matters** page, open the **⋮** menu on the matter
2. Click **Share**
3. Tick the colleagues who should have access

People you share with can open the matter and work in it. Only the matter's owner can rename it, delete it, or change who it is shared with, so **Share** only appears on matters you own. If nobody else is in your organisation yet, the Share dialog explains how to invite colleagues. See [Data privacy & security](https://docs.courtaid.ai/account-and-billing/privacy-and-security.md).

## Matter chat

Matter chat is one of CourtAid's most powerful features. It lets you ask questions across **your documents and the court database together**.

![Matter workspace with uploaded files and chat](https://1143104512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoFACnrJdsxVDAKioc81%2Fuploads%2Fgit-blob-0d1088d4542f29ff751b2464aa9f9c5f83fea24b%2Fmatter-chat.png?alt=media)

The matter workspace shows your uploaded files on the right and a chat panel on the left. CourtAid searches both your matter documents and its 2M+ court database to answer your questions.

### Starting matter chat

**Option 1 — From the Matters page:** Click the **Chat** button on any matter row.

**Option 2 — From chat input:**

1. Click the **+** or paperclip icon on the chat input
2. Choose **Select Matter** and pick your matter
3. Start typing your question

**Option 3 — From the matter workspace:** Open the **AI Assistant** tab or click **+ Chat**.

### What you can ask

Once a matter is attached, its name appears above the chat input, labelled **matter**. Click the **×** to detach it and return to normal chat.

Example questions:

```
Summarise the key facts from the uploaded pleadings
What cases support our argument on limitation periods?
Compare the indemnity clause in our contract with standard NSW precedents
What dates are mentioned across all documents in this matter?
```

### Matter files panel

During matter chat, a panel shows the matter's files (toggle it with **Show matter files** / **Hide matter files**). From here you can:

* Upload new documents
* View or delete existing files
* Move or copy documents between matters

## Saving documents to matters

When you find a useful case in Search, click **Save** on the result and choose which matter to add it to. This builds a curated collection of authorities alongside your own files.

## Related features

Matters connect to other CourtAid tools:

| Feature              | How it links to matters                                                                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Chronologies**     | Build event timelines from the matter's documents — workspace **Chronologies** tab. See [Chronologies](https://docs.courtaid.ai/matter-workspaces/chronologies.md) |
| **Tabular View**     | Extract structured data across the matter's files — workspace **Tabular** tab. See [Tabular View](https://docs.courtaid.ai/matter-workspaces/tabular-view.md)      |
| **Document Drafter** | Draft documents grounded in the matter's files — workspace **Drafts** tab. See [Document Drafter](https://docs.courtaid.ai/chat-and-documents/document-drafter.md) |
| **Chat history**     | Review past matter conversations — workspace **Chat history** tab                                                                                                  |
| **PDF enrichment**   | Scanned PDFs are automatically processed when uploaded — see [PDF enrichment](https://docs.courtaid.ai/chat-and-documents/pdf-enrichment.md)                       |
| **Compare**          | Compare two document versions — see [Document comparison](https://docs.courtaid.ai/matter-workspaces/document-comparison.md)                                       |

## Example workflow

A typical matter workflow:

1. **Create** a matter with the matter name, client, and Case ID
2. **Upload** key documents — pleadings, correspondence, expert reports (scanned PDFs are enriched automatically)
3. **Search** for relevant cases and **Save** the best ones to the matter
4. **Chat** with the matter to synthesise findings
5. Run a **Tabular review** to extract key fields across all documents at once
6. **Generate a chronology** from the uploaded documents
7. Return to **Chat history** later to pick up where you left off

## Tips

* **Name matters clearly** — include client or case identifiers for easy searching later
* **Save cases as you go** — don't rely on memory; save authorities to the matter during research
* **Use Client ID / Case ID** — these fields help if you integrate with practice management systems, and you can search by them
* **Move files out of Loose Files** — keep Loose Files as an inbox; organise into named matters regularly


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.courtaid.ai/matter-workspaces/matters.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
