> 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/attachments-and-file-library.md).

# Attachments & File Library

Add files, use supported previews and review controls, and manage attachment access along with finding, previewing, organizing, and reusing the files accessible in a workspace.

Attachments are files kept with a supported workspace resource, such as an investment. Add a file to keep the evidence close to the work. Open the resource’s **Attachments** area to see files you can access.

### Adding and Opening Files

Use **Add Attachments** or the upload area to select files. Confirm that they have uploaded and appear under the intended resource. Upload access and available controls depend on the resource and workspace permissions.

Open an attachment to inspect it. Supported files can show a browser preview. Use the available download or original-file option when the preview is unavailable or you need the source file.

### Reviewing Document Evidence

Where the file supports text selection, use the viewer to find a passage and open the available copying, commenting, or research controls. Use a source reference when the finding belongs in a memo.

For compatible files, Ontology Mode adds concept annotations. Some PDFs need text recognition before their content is available for annotation.

### Managing Access and Revisions

{% hint style="warning" %}
**Before Sharing a File Link**

An attachment follows the resource and applicable file permissions. Review those permissions before sharing a file link.
{% endhint %}

Where the viewer offers version or replacement controls, check which file version supports the research.

Use the available removal actions when a file no longer belongs with a resource. Confirm that colleagues can still reach material needed to verify earlier work.

The workspace attachment library brings accessible uploads into the **Attach Files** picker. Use it to find a private working file, an attachment shared through a research resource, or an eligible file to use in an Agent request. The workspace you are in and your access to each resource determine what appears.

### Finding Files in the Library

Open **Attach Files** from a supported attachment area or Agent composer. Choose the workspace library, then switch between **My Uploads** and **All Accessible Files**. Use the search and filters to narrow the results by file scope, resource, uploader, or file type where those options are available.

| Library View           | What You Can Find                                                                                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| My Uploads             | Files you uploaded in the current workspace. Use this view to find your own working materials quickly.                                                      |
| All Accessible Files   | Your files and uploads shared through resources you can access. Use the File Scope and Resource filters to find the evidence attached to a specific record. |
| Connected Data Sources | Files available through a selected provider account. These items follow the provider's access and appear in the connected account picker.                   |

### Understanding File Scope

A private workspace upload belongs to its uploader. Files attached to supported resources such as Investments, Lists, and Tasks follow the access rules for the resource and file. An attachment added to a List record is tied to that record, which matters when a List contains several records with similar names.

When adding files, check the resource and record you are viewing. Use folders to keep related files together. Available rename, move, and removal controls depend on the file and your permissions. Folders and their contents keep the same scope when you organize them.

{% hint style="warning" %}
**Check Who Can Open the File**

A colleague needs access to the resource and the attachment. Before referring a review group to an exhibit, check that the original upload is in the intended scope and that reviewers can open it.
{% endhint %}

### Previewing and Reusing Existing Files

Select an item to preview it where supported. For files that need a different viewer, use the available download or original file control. To reuse a supported file, select it in the picker and review the resulting attachment or prompt selection before continuing.

The library supports more formats for storage than the Agent composer accepts as inputs. For example, a spreadsheet can be useful to keep with an Investment even when it cannot be selected as an Agent file input. Choose an eligible PDF or image when you need the Agent to inspect the file directly. Use a supported Data Block or connected source when structured data is the appropriate input.

### Copying a File to a Data Source

{% stepper %}
{% step %}

#### Select the Workspace Original

Find the intended file in the library. Open its menu and choose **Copy to Data Source** where available.
{% endstep %}

{% step %}

#### Choose the Account and Destination

Select the connected account and confirm the folder or destination. Verify both before submitting the copy.
{% endstep %}

{% step %}

#### Confirm the Result

Check the destination in the provider. If the result needs review or the copy fails, check whether a file already exists before trying again. The original remains in Countercyclical.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Copies Have Separate Lifecycles**

Copying creates a separate file in the connected service. Later edits, moves, or removals in Countercyclical leave the external copy as it was.
{% endhint %}

### Related Pages

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

{% content-ref url="/pages/ChFsQfp8HPAThQm7tmPz" %}
[Sharing & Embedding](https://docs.countercyclical.io/workspaces/sharing-and-embedding.md)
{% endcontent-ref %}

{% content-ref url="/pages/kkAAVbM6pyvaAWXRNYOi" %}
[End-To-End Source Attribution](https://docs.countercyclical.io/companies-funds-and-entities/end-to-end-source-attribution.md)
{% endcontent-ref %}
