> For the complete documentation index, see [llms.txt](https://docs.corraldata.com/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.corraldata.com/kb/chat-with-your-data/attach-files-to-askcorral.md).

# Attach Files to AskCorral

Sometimes the context you need isn't in your connected data — meeting notes, a campaign brief, a vendor doc. You can attach files directly to an AskCorral conversation and the AI will read them and use them as context alongside your live data.

{% hint style="warning" %}
File attachments are rolling out gradually. If you don't see the attach option in your composer yet and want it enabled for your account, contact <support@corraldata.com>.
{% endhint %}

### How it works

**Click the attach button** in the AskCorral composer, or **drag a file** into it. Each attached file shows as a chip with its name and size — remove one with the × before sending. Then ask your question: *"Here are my notes from the ops meeting — which of these action items can you check against our actual numbers?"*

* **Supported today:** plain text (`.txt`), Markdown (`.md`), CSV (`.csv`), and HTML (`.html`, `.htm`) files. A CSV is read as text in that conversation and isn't joined to your connected data. Unsupported types are rejected with a message naming the type; more formats are on the way.
* **A few files per message,** with a per-file size limit — the composer will tell you if a file is too large to include.
* **Session-scoped:** attachments live with that conversation. They're removed when you delete the conversation, and swept automatically after a retention window — they don't become part of your connected data. See [HIPAA, PHI and AI](https://docs.corraldata.com/kb/security-and-privacy/hipaa-phi-ai.md).
* **Private to your account:** files are isolated per customer and per user, enforced server-side.

### Good uses

* Paste-averse context: a brief, a checklist, meeting notes, a KPI definition doc
* "Compare this plan against our actuals" — attach the plan, let AskCorral pull the actuals
* Terminology: attach a glossary so the AI uses your team's language for a session

{% hint style="info" %}
Want a file to become a permanent, queryable data source instead? That's an integration, not an attachment — see [Connect your data](https://docs.corraldata.com/kb/getting-started/quickstart) for the Google Sheet, Drive, and OneDrive paths.
{% endhint %}


---

# 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.corraldata.com/kb/chat-with-your-data/attach-files-to-askcorral.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.
