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

# Associations

Discover and navigate relationships between workspace resources through bi-directional references.

Associations provide a bi-directional referencing system that connects related resources across Countercyclical. They allow users to quickly identify which workspace resources reference one another, providing immediate visibility into the relationships between Investments, Memos, Folders, Pipelines, and other supported resources.

See also [Ontology Mode](https://docs.countercyclical.io/workspaces/ontology-mode) and [Tags](https://docs.countercyclical.io/workspaces/tags).

Rather than manually tracking where information is referenced, Associations make these connections discoverable directly from the resources themselves.

### How Associations Work

Associations establish **bi-directional relationships** between workspace resources.

When one resource references another, the relationship can be viewed from both sides. This means you can see not only which resources are referenced within a particular resource, but also where that resource is referenced elsewhere in your workspace.

For example:

* A **Memo** discussing a particular Investment can be associated with that Investment.
* The **Investment** can display the Memo as an associated resource.
* A **Folder** referenced within a Memo can also appear as an Association, allowing users to navigate between the two resources.

This creates an interconnected network of workspace resources, making it easier to understand how research, documentation, and workflows relate to one another.

### Viewing Associations

Associations are accessible through the **Associations** indicator within supported workspace resources.

The indicator displays the number of associated resources, providing a quick overview of how many connections exist.

To view Associations:

1. Open a supported workspace resource.
2. Locate the **Associations** indicator.
3. Click the indicator to open the Associations interface.
4. Browse or search the associated resources to explore their relationships.

Associations help you quickly identify relevant resources without manually searching through documents, folders, or research materials.

### Creating Associations

You can establish Associations by referencing other workspace resources within supported interfaces.

To manually associate a resource:

1. Open the workspace resource where you want to establish a reference.
2. Open the **Associations** interface.
3. Search for or browse the available workspace resources.
4. Select the resource you want to associate.

Once established, the relationship is accessible from both associated resources.

Associations may also be established through supported resource references, allowing connections to emerge naturally as research and documentation develop.

### Bi-Directional Referencing

The defining characteristic of Associations is their **bi-directional visibility**.

Unlike conventional hyperlinks, which typically connect one document to another in a single direction, Associations allow users to discover relationships from either resource.

Consider an investment research workflow:

| Resource             | Associated Resource  | Relationship                                        |
| -------------------- | -------------------- | --------------------------------------------------- |
| Investment           | Investment Memo      | The Memo discusses the Investment.                  |
| Investment Memo      | Due Diligence Folder | The Memo references supporting diligence materials. |
| Due Diligence Folder | Investment Memo      | The Folder is referenced by the Memo.               |

This allows users reviewing an Investment to discover relevant Memos and supporting documentation, while users reading a Memo can identify the resources associated with its analysis.

### Research Context and Discoverability

Associations are particularly valuable when research spans multiple workspace resources.

As Investments, Memos, Pipelines, and Folders become interconnected, Associations provide an accessible view of how information is distributed throughout the workspace.

Common use cases include:

* **Investment Research:** Identify Memos, Folders, and other resources that reference a particular Investment.
* **Due Diligence:** Discover which research documents discuss or reference supporting diligence materials.
* **Pipeline Management:** Understand how resources moving through a Pipeline relate to other workspace materials.
* **Research Collaboration:** Quickly locate related resources when reviewing another team member's analysis.
* **Knowledge Discovery:** Find relevant research and documentation through existing resource relationships.

By exposing these connections, Associations reduce the need to manually trace references across multiple resources.

### Associations vs. Mentions

Associations and Mentions work together to connect information throughout Countercyclical.

| Feature             | Associations                                                      | Mentions                                                                                   |
| ------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Purpose**         | Surface bi-directional relationships between workspace resources. | Reference resources, people, or other supported entities within content and conversations. |
| **Visibility**      | Discoverable from either associated resource.                     | Visible within the content where the mention appears.                                      |
| **Primary Benefit** | Understand where resources are referenced or discussed.           | Provide direct context within a specific discussion.                                       |
| **Example**         | See which Memos reference an Investment.                          | Mention an Investment in a comment or Agent conversation.                                  |

Mentions provide contextual references within content, while Associations make relationships between resources discoverable across the workspace.

### Why Associations Matter

As a workspace grows, information naturally becomes distributed across multiple resources. A single Investment might be discussed in several Memos, referenced by supporting documents, and incorporated into different research workflows.

Associations provide a centralized way to discover these relationships without requiring users to remember where each reference originated.

Through bi-directional referencing, Countercyclical helps users understand not only **what a resource contains, but also how it connects to the rest of their workspace.**

#### Related Pages

{% content-ref url="/pages/bevBlNIDnSbsuOgT5SVt" %}
[Ontology Mode](https://docs.countercyclical.io/workspaces/ontology-mode.md)
{% endcontent-ref %}

{% content-ref url="/pages/yxsmPPVKK0g5VYvxdvQv" %}
[Tags](https://docs.countercyclical.io/workspaces/tags.md)
{% endcontent-ref %}

{% content-ref url="/pages/fRZkiRDgRm8ATJboaM2r" %}
[Mentions & Context Previews](https://docs.countercyclical.io/workspaces/mentions-and-context-previews.md)
{% endcontent-ref %}
